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• Completely new integrated 32-bit 
visual development environment 

• Powerful, fully integrated and 
automated media builder 

• Drag-and-drop visual file layout allows 
for easy modification and updates 
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Need to post demos 
on the Internet? 


'an Bricklin's 



Works great on 
the Internet, online 
senates & CD-ROMs/ 


The Demo Builder for Windows 



[rftAittever kinA Acm.0 you uvAnt Is wAnt yon ffet uvitA Aimo-it! 

Upload an Interactive demo to the Internet. Quickly put together sales presentations. 
Produce electronic brochures for potential customers. Create self-running 
demos. Supply your in-house staff with tutorials. Promote sales with 
disk-based advertising. 

y\o time to tiArn An AntAorintootlr Y[o profriim! 

You need to create a demo to show off your software, and you 
need it yesterday. You don't have time to learn an authoring tool— 
all you want is to create an effective sales tool. Since demo-it! 
requires NO programming, has great online help and informative 
documentation, you can create a professional-looking demo quickly. 
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hen you can't be there to demonstrate a program yourself, 
Dan Bricklin's demo-it! makes an effective stand-in. // 

—PC Magazine, April 11, 1995 



‘Just took At son %e oft tAe fteAtnres: 

Version 2.0 of demo-it! is even more feature-rich than the best-selling Version 1.0 
Enhanced special effects, including Implode and Explode 
Is completely WYSIWYG—no need for you to worry about font support 
Works great on disk, CD-ROMS, Internet and online services 
Launches external programs 

Has rich text support—use several fonts and styles in one object 
Supports variables and conditions 
Creates a familiar "slide show" about your product 
Text, lines, buttons, pictures, rectangles, slides, overlays 
& underlays are easily created 
Supports events 

Has actions such as next slide, previous slide, go to slide, 
play a .WAV file, run a program, etc. 

Has a screen capture utility with many features 
Runs demos directly from floppy disk—no need for users to change 
their hard drives 

Comes with a freely distributable 170K runtime player 
Creates small, compact demos. 
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managers. All Win32 programs use at least one heap created by HeapAllocQ (and your 
compiler's mallocQ may actually be built on top of HeapAlloc()). Also, OLE programs com¬ 
monly use IMalloc for allocating dynamic data to be exchanged. This article uses some 
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How big a chunk of virtual addresses does mallocQ reserve at a time? Would you believe, 
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erly for all data types? Would you believe the answers include “yes,” “no," and “depends on 
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Horizontal Listbox Scrolling with MFC Muthuvaie Shanmugam 31 
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Although you have to explicitly tell Setup to install it, Windows 95 comes with a tool called 
SYSMON that graphically displays various dynamic system statistics over time. SYSMON is 
extendible, but only at the VxD level. This article provides a wrapper VxD and DLL that lets 
any program display custom statistics with SYSMON. 
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Muthuvale Shanmugam shows an MFC class that limits the maximum line length in 
multi-line edit controls. Dan Shappir discusses useful applications for C++’s ability 
to initialize static data with complex expressions. Patrick Tennberg provides two 
conversion functions to make it easy to store binary data in .ini files. Manish Apte 
provides a VxD that helps VxD authors emit simple debug strings. Thierry G. 
Marneffe shows how to keep non-ready drives from appearing in a CComboBox list 
of available drives. Dan Shappir provides further discussion of resource leaks. 

Understanding NT Paula Tomlinson 57 

NT security is complicated, with lots of new acronyms, API functions, and data 
structures to learn. However, most programmers need to learn only a few basic 
things about security to accomplish the most common tasks. This column provides 
the basic concepts you need to understand. 

Bug++ of the Month Mark Nelson 63 

Visual C++ v4.2 features an implementation of the Standard Template Library 
(STL). Since the STL and MFC have a lot of overlap in functionality (but not in 
design), you might wonder how well they work together. Reader Dave McAlpin finds 
they don’t always work together at all, as just including the wrong STL header can 
keep code that uses MFC's CString class from compiling! 

Books in Brief Ron Burk 65 

Java Database Programming, by Brian Jepson (reviewed by Victor Volkman); 
Building Internet Applications with Delphi 2, by Davis Chapman (reviewed by 
George Tylutki); Kick Ass Delphi Programming, by Don Taylor, Jim Mischel, John 
Penman, and Terence Goggin (reviewed by George Tylutki). 
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Let's face it - when you need a disassem¬ 
bler you're looking for clear, reliable informa¬ 
tion. Those who have tried other products 
have been disappointed with the dismal re¬ 
sults. 

Clearly, a new standard of excellence! 

Sourcer solves these problems with ad¬ 
vanced analysis and simulation. The quality 
of output is so good that most DOS EXE & 
COM files and drivers reassemble perfectly, 
byte-for-byte identical to the original! 

To make the results easier to understand 
Sourcer provides detailed and descriptive 
comments for interrupt subfunctions, I/O 
ports and much more. Sourcer even lets you 
examine encrypted and packed programs. 


mov ax,2517h 
mov dx .offset int_17h_entry 
int 21 h 

mov dx,offset data_4 
mov ah ,9 
int 21 h 


mov dx,19h 
mov ah,31h 


; DOS Services ah=function 25h 
: set intrpt vector al to ds:dx 
; ('Halt when ? printed,') 

; DOS Services ah=function 09h 
; display char string at ds:dx 


; DOS Services ah=function 31 h 
; terminate and stay resident 
; akreturn code,dx=paragraphs 


int_17h_entry proc far 
pushf 

cmp al,3Fh 


; Push flags 


Partial Disassembly of a Virus 

C/C++ and Pascal 

Some C, C++ and Pascal developers hate 
disassembly because the source code they get is 
assembly. We can't change that, but we can 
make it easier for you by automatically identi¬ 
fying the use of parameter passing and local 
stack variables. Parameters pushed onto the 
stack prior to a subroutine call are clearly com¬ 
mented. 

Get commented BIOS listings 

The BIOS Pre-Processor creates commented 
listings for any BIOS ROM. Understand how 
your specific BIOS works! Adds over 75K of 
comments specific to your BIOS. Inserts labels 
like "int_ 10_video". And if s fully automatic. 

Windows disassembly! 

Windows Source generates detailed listings 
of Windows EXEs, DLLs, VxDs, device 
drivers, & OS/2 NE files. Windows Source 
labels, byname, export & import function calls, 
API calls like "GetModuleHandle", undocu¬ 
mented APIs. VxD functions and much more. 

Call now! 
1 - 800 - 648-8266 

Sourcer $149.95 

Sourcer & BIOS Pre-processor 189.95 

Sourcer & Windows Source 249.95 

Sourcer, BIOS & Windows Source 289.95 

Shipping: USA $6; Canada/Mexico $10; All others $25. 

CA residents add sales tax. © 1994 VISA/MC/Amex/COD 

30-DAY MONEY-BACK GUARANTEE 
V Communications, Inc. 

4320 Stevens Creek Blvd., Suite 120-WD 
San Jose, CA 95129 408-296-4224 
FAX 408-296-4441 



In the Internet-means-free-stuff department: Microsoft has released version 3.0 of 
their Internet Information Server (IIS), which you can download for free if you own NT 
Server v4.0. Just hop over to http: //www. mi crosoft. com/i i s and start downloading. 
AT How about more free stuff? More software companies are now putting 
fully functional demos on the Web. Of course, the demos are time-locked, and they 
hope you will cough up the cash after you try out the product. But I wonder if this 
means of distribution presents problems of buyer psychology. After you download a 
time-locked demo for free, does that make you less likely to pay serious dollars for an 
identical (except not time-locked) version that typically includes little extra in the way 
of support or printed documentation? AT Time for an unscientific survey. How 
many of you have downloaded a fully functional demo from the Web? (If you can’t find 
any, check out www. pureatri a. com for Purify for Windows NT, or www.numega. com for 
BoundsChecker.) Was getting the demo software downloaded and installed more or less 
hassle-free? How thorough of an evaluation did you accomplish before the demo 
expired? Did you go on to buy the product? Send me (70302.2566@compuserve.com) 
notes on your experiences. AT Can’t find any interesting evaluation software to 
download? Then you’re not trying very hard. As I write this, the “preview edition” of 
Borland C++ Builder (their new C++-meets-Delphi product) is available at 
www.borl and.com. On the other hand, not all the vendors are trying hard enough. Some 
vendor home pages make it nearly impossible to find the download you’re looking for. 
AT Articles wanted: On how to accomplish minimal Internet-enabling for Win32 
applications. I’m looking for small, reusable code that will let me easily give my appli¬ 
cation the ability to handle the most common tasks. For example, I want a simple func¬ 
tion that lets me “go to” a given URL, using whatever browser is currently running, or 
else launching the default browser. Another example: a small function for sending a 
simple text email message to a given address, useful for sending automatic email regis¬ 
tration. AT If you’re writing floating-point applications, you probably already 
view Windows as a hostile environment. I was still surprised to discover that both 
Borland and Microsoft provide memory management functions that practically guaran¬ 
tee misaligned floating-point data, resulting in needlessly slower calculations. If 
you’re just using new or mall 0C( ) to allocate space for that big matrix of doubl es, you 
might be able to get a significant speedup with a simple wrapper function. Check out 
the compiler benchmark article on page 6 of this month for this and other interesting 
facts about memory allocation. AT The question of the month is: Are you writing 
any better code than you were five years ago? Reworded, what tools and techniques 
help you produce higher-quality software than you did five years ago? AT There’s 
nothing like getting something for free, and Windows 95 happens to include a free user 
interface for graphically viewing time statistics of simple integers. Check out Vitaly 
Vatnikov’s article on page 37 of this issue, in which he builds a VxD and DLL that let 
any application easily produce custom statistics for the Windows 95 SYSMON utility. 
Grab the necessary libraries and binaries from our Web site at WWW . wd j . com, and let me 
know what applications you find for this nifty feature. 

Ron Burk, Editor 

RonBurk@compuserve.com 

www.burklabs.com 



Please do not send press releases to this address. Send press releases to Miller Freeman, Inc., 
1601 W. 23rd St., Ste. 200, Lawrence, KS 66046; Fax 913-841-2624; wdletter@mfi.com. 
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Save months of TCP/IP programming! 


Fill in properties 






OLE Custom Controls 

Just ask any OCX jockey. With Distinct’s Visual Internet 
Toolkit, adding TCP/IP connectivity to your application 
is not much farther than a drag-and-drop away. 
Whether you need a customized FTP client or most 
any other Internet application, you can simply embed 
an OCX into your program and Visual Internet 
will do the rest. It’s that easy. And you’ll have 
great looking, powerful applications. 


Protocols 

• Windows Sockets 

• Telnet 

• TCP/UDP/ICMP 

• VT 220 

• PPP/SLIP/CSLIP 

• WinSNMP 

• E-mail/SMTP 

• ONC RPC/XDR 

• POP 2/POP 3 

• rep 

• News/NNTP 

• rexec 

• FTP 

• rlogin 

• TFTP 

• rsh 

• TCP Server 

• And many more 

Interfaces* 

Environments 

• 32 bit (95 and NT) 

• Visual Basic 

• 16 bit (Windows 3.x) 

• Visual C/C++ 

• C++ Class libraries 

• Delphi 

• DLL’s 

• C/C++ 

• OCX’s 

• Access 

• VBX’s 

• FoxPro 


32 Bit Performance 

The power of our new 32 bit Visual Internet Toolkit 
is simply unsurpassed. More custom controls. More 
protocols. More sample code. More Documentation. 
Which makes your job easier and leaves the 
competition in the dust. 


{ 


Call now for 
30 minute 
Internet Jl 
Delivery! *j.^. 



ik Af . 

distinct 


The world leader in Internet development tools. 


u 408.366.8933 

World Wide Web: http://www.distinct.com 
Fax: 408.366.0153 

E-mail: windev@distinct.com 

Fastfacts: 408.366.2101 


•Not all interfaces may be available for all protocols, licensing fees required for redistribution. Distinct is a registered trademark and 30 minute Internet Delivery! and Visual Internet is a trademark of the Distinct Corporation. Copyright 1995 Distinct Corporation, 12900 Saratoga Avenue, Saratoga, CA 95070. All rights reserved. Specifications and delivery terms are subject to change without notice. 
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Memory Management 

Ron Burk 
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“IMalloc and 
HeapAllocO get used 
in a lot of Win32 
programs, so it’s 
worth taking the time 
to get a feel for how 
they work. Most 
compilers offer a new 
or malloc() that is 
significantly more 
efficient than these 
two allocators, but 
you can’t use mallocQ 
for everything.” 


Ron Burk is the editor of Windows Developer’s 
Journal. You can reach him at www.burklabs.com 
or RonBurk@compuserve.com. 


Benchmarking HeapAllocO and IMalloc 

As I was building programs to measure various C/C++ memory management packages, 
it dawned on me that Win32 programs often use more than one memory manager at the 
same time. Win32 includes at least two built-in memory managers with features similar to 
malloc()/free() or new/delete. First, OLE provides IMalloc, an interface that provides 
central memory management so an OLE object in one module can allocate memory that can 
be freed correctly by an OLE object in a separate module. Second, the HeapAl 1OC () family of 
Win32 functions provides basic memory management similar to ma 11 OC (). While you proba¬ 
bly know whether or not your program is using I Mai 1 OC, you may not be aware that every 
Win32 program has at least one HeapAl 1 OC()-style heap associated with it; the default 
process heap (available by calling GetProcessHeap( )) serves much the same purpose that the 
local heap served for Win 16 programs — it provides a central heap that DLL code can use, no 
matter what application loaded the DLL. Of course, the default Win32 process heap is much 
less likely to run out of memory than the old Winl6 Local A1 1 OC()-style heap. 

Given how many Win32 programs rely on these memory managers, I became interested 
in learning something about their characteristics. I took some of the benchmarks I had built 
for C/C++ compilers and applied them to both kinds of Win32 heaps. I also ran the bench¬ 
marks under both Windows 95 and Windows NT v4.0 (service pack 1) to see whether there 
were significant differences between the two operating systems. As with most every bench¬ 
mark I’ve run, I found some interesting and unexpected results. 

Most of the source code and more detailed explanations for the benchmarks I ran are in 
the article “More C/C++ Memory Management Benchmarks” (see page 15). Here, I will 
focus mainly on the results of the benchmark and my interpretations. 

It’s important to note which kind of HeapAl 1 oc () heaps I have tested here. HeapAl 1 oc() 
is thread-safe, but only if you use appropriate flags to tell it to protect against concurrent 
access. In these tests, I did not use those flags, so the results should be faster execution 
because HeapAl 1 OC() did not have to use critical sections or other devices to synchronize 
access to internal data structures. While the default process heap is thread-safe, it’s common 
practice to not use thread-safe heaps if you are creating a separate heap for your own use, 
and that’s what is benchmarked here. 

Alignment 

I began with the easiest benchmark — determining the alignment of the memory 
returned by the two memory managers. Although the Intel family of processors does not (by 
default) raise an exception if you access misaligned data, it does access the data more slow¬ 
ly. For example, if you were creating a large array of 32-bit integers, you would want the 
array address to be aligned on a four-byte boundary for best speed; for an array of 64-bit 
doubles, you would want the array address to be aligned on an eight-byte boundary. 
Therefore, it’s always nice to know what alignment a given memory allocator provides, 
though I could find no such documentation for IMalloc or HeapAllocf). 

Running my simple alignment test showed that both IMalloc and HeapAllocO produce 
memory addresses aligned on four-byte boundaries. Most Win32 programs use data and data 
structures that will work fine with four-byte alignment. The exception is programs that make 
extensive use of doubl es. For example, on my 133Mhz Pentium, the floating-point benchmark 
in a 1 f 1 oat. cpp (Listing 1) runs about twice as fast when the floating-point array is aligned on 
an eight-byte boundary than it does when the array is aligned on a four-byte boundary. 

Visual C++ programmers should also keep in mind that Visual C++ uses “automatic 
alignment” by default when deciding the alignment for structure members. Suppose you are 
using Visual C++ and you define a structure like this; 

struct WorldPoint 

{ 

int Type 
double X; 
double Y; 

}; 
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Ultima te Grid 

100% MFC Object Oriented Design 

The Premier Grid control for MFC/C++ development, Ultimate Grid provides an 
outstanding 100% MFC object oriented design. Unparalleled power, Unparalleled features, 
Ultimate performance. 

Solid. Powerful. Professional. 

Ultimate Grid was designed from the ground up as a solid, professional tool to satisfy your 
development needs. Based on powerful MFC classes. Ultimate Grid can be easily used as a 
CWnd, CView, CDialog, dialog resource, or a pop-up! 

Ultimate Grid includes all the features you expect, and an extensive list of powerful new 
features you can depend on. It connects easily to standard data sources such as DAO, 
ODBC, SQL, CodeBase, and c-tree plus. And, you can very easily connect to proprietary or 
other 3rd party databases, or use the built-in memory manager for pre-loading. 

The professional edition includes full source code and allows you to develop custom data 
sources and new cell types, gives you enhanced debugging capability and greater 
development flexibility. 

Ultimate Grid compiles right into your app; no ActiveX control or DLL to include! It's 100% 
Royalty-free, just like all Dundas products, and includes a 30 day money-back guarantee. 

Call today, or visit our WWW site and find out for yourself why developers the world over are 
flocking to Ultimate Grid and making it the cornerstone of their development projects. 


Entry-Level 

Professional (w/ full source code) 


$149.00 

$349.00 


Generic C++ and ActiveX versions are also available. Call or visit our Web site for full details. 



Ultimat e TCP/IP 

Internet/Intranet Client and Server Development Kit 


* POP3 
SMTP 
s' HTTP 


Ultimate TCP/IP allows you to design full-featured, 
powerful FTP, HTTP, DNS, Finger, SMTP/POP3 
applications, as well as proprietary protocols quickly 
and easily! Modify our sample server and client code 
to get exactly what you want instantly! Easily create 
multi-threaded Internet server applications that run 
as true Windows NT services. 


s' FTP 
s' DNS 
s' And More 


1 800 463 1492 


Sales: 

Fax: 

EMail: 

WWW: 


416 239 7472 
416 239 2183 
sales@dundas.com 
www.dundas.com 


Whether you are developing for the intranet or 
internet, Ultimate TCP/IP will be your trusted 
guide. Our well-constructed C++ classes allow you 
to solve both sides of the client/server equation. 


Entry-Level 

Professional (w / full source code) 


Dundas Software 


• 30 day money-back satisfaction guarantee. 

• Visa. MasterCard, American Express, check, money order. 

• We will deliver via Internet, CompuServe, mail or courier. 

• All prices in US dollars 


Dundas Software Ltd. 

• 500 - 4800 Dundas Street West, 

Etobicoke, Ontario, Canada, M9A 1B1 

• 670 - 240 Portage Rd., Lewiston, 

New York, USA, 14092 

Windows is a registered trademark of Microsoft Corp. All other products are trademarks or registered trademarks of their respective owners. 
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In that case. Visual C++ will pad the first member (Type) with an extra 
four bytes so that X and Y both lie on an eight-byte boundary for maxi¬ 
mum efficiency. Unfortunately, if you allocate space for a structure of 
type WorldPoint using IMalloc or HeapAllocO, all the compiler’s 
hard work may go to waste — the structure may start out on a four- 
byte boundary, causing both the double members to be misaligned. 
Your code will still work, but it will execute more slowly, even though 
the compiler sacrificed space to keep that from happening. 

If you need to use either of these memory managers but need 
memory that’s aligned on eight-byte boundaries, one easy fix is to 
just always allocate four bytes more than you need: 

void* Address - MALL0C(Needed+4); 
if((1onglAddress & 0x0007) 

Address - (void*)((long)Address + 4); 

This code assumes that MALL0C 0 is a macro that expands into a call 
to some memory manager that only guarantees four-byte alignment. 
This solution potentially wastes a bit of space, but unless you are 
making a very large number of fairly small allocations, it may be 
preferable to the amount of effort required to create a custom allo¬ 
cator that provides eight-byte alignment. This solution ignores the 
fact that you still need the original address when it comes time to 
free the memory. 


Listing 1: alfloat.cpp — How slow is misaligned data? 


/* alfloat.cpp - examine effect of mi salined doubles */ 
^include <assert.h> 

//include <stdio.h> 

//include <stdlib.h> 

//include <windows.h> 

^define ARRAY.SIZE (1024*2) 

void BenchmarkCdouble* Array, const char* Name) 

{ 

int i, j; 

DWORD Start. Stop; 
printf("Benchmark starts.\n"); 

Start = GetTickCount(); 
for(i - 0; i < 1000; ++i) 

{ 

for(j - 0; j < ARRAY.SIZE; ++j) 

Array[j] - i; 

for(j - 0; j < ARRAY.SIZE; ++j) 

ArrayEj] +- 3.5; 

} 

Stop - GetTickCountC): 

printf("Array-0x!£08x\n", Array); 

printf("Mi 11 iseconds for ’%s* - !6d\n", Name, Stop - Start); 

} 

void main(void) 

{ 

int Gap-1; 

void* Address; 
double* Array-0; 

Address - mal1oc((sizeof(double)*ARRAY_SIZE)+4): 
if((long)Address & 0x0007) 

Array - (double*)Address; 

else 

Array - (double*)((1ong)Address + 4); 

/* do it twice to reduce possible caching effects */ 
Benchmark(Array, "4-byte aligned"); 

Benchmark(Array, "4-byte aligned"); 

if(!((long)Address & 0x0007)) 

Array - (double*)Address; 

else 

Array - (double*)((1ong)Address+ 4); 

Benchmark(Array, "8-byte aligned"); 

Benchmark(Array, "8-byte aligned"); 

} 

//End of File 


• windows developer’s journal • www.wdj.com • 


8 


April 1997 











































Canon 


Claris 


ichat 


Xerox 


WITHOUT US THEY 
WOULDN'T EXIST 
(OH AT LEAST THEY'D 
BE MUCH MORE 
FRUSTRATED.) 


America Online 


Apple Computer 


Broderbund Software 


CompuServe 


Dataware 


Digital Equipment 


Fujitsu 


GE Information Systems 


Macromedia 


National Geographic 


Now Software 


QualComm 


CONS! 1 the possibilities. They’re 
wide open. Simply put, OpenPaige" can 
do anything you want to the text of your 
software application. 

Across platforms, across architectures, 
even UNIX". OpenPaige is a feature-rich 
text environment. Every aspect of text and 
layout formatting, editing and display is 
possible. Stylized text. Scaling. Container 
and non-rectangular shapes. Style sheet 
support. Cut, copy and paste. Embedded 
pictures, objects, buttons and even calls to 
other applications are at your fingertips. 

Don’t waste time struggling with your 
text. We’ve already done the work for you. 
Drop in OpenPaige and go. Use as much or 


as little of it as you wish. Available as 
object code or as source code, it has 
an elegantly small footprint. Yet it will 
empower you to open doors, boundaries, 
and minds with your software application. 

But don’t take our word for it. Check 
out our extensive and diverse client list. 
They’ve all discovered how the robust and 
flexible power of OpenPaige can open up 
entire new worlds of possibilities. 


Seagate Software 


Paige 


Datapak 


For additional information, check out our web site at www.datapak.com/-datapak/ or call us at 1-800-327-6703. 

Copyright ©1997 Datapak Software. Paige and OpenPaige are trademarks of Datapak Software. All brand or product names are trademarks or registered trademarks of their respective holders. 

Datapak Software 11815 NE 99th Street, Suite 1200, Vancouver, WA 98682 • Phone: 360.891.0542 • Fax: 360.891.0743 • E-mail: sales@datapak.com 

□ Request Reader Service #107 □ 




Internal Fragmentation 

I next set out to discover the “internal fragmentation,” or space 
overhead per allocation, associated with IMalloc and HeapAllocO. 
Having determined that these allocators align on four-byte bound¬ 
aries, I already knew that the overhead must be at least three bytes, 
since that would be the minimum overhead needed to make a one- 
byte allocation align properly. 

I used the i ntf rag. cpp benchmark to allocate memory segments 
of various size and calculate the number of bytes actually consumed 


by each allocation. Table 1 shows the results for both memory alloca¬ 
tors, under both Windows 95 and Windows NT v4.0 (service pack 1). 

The easiest inference to draw from Table 1 is that Win95 and NT 
probably do not share the same code for these memory allocators. 1 
don’t see anything inherently operating system-specific in these 
APIs, so I thought it possible that both platforms would use identi¬ 
cal code. Under Win95, the results don’t discourage me from sus¬ 
pecting that IMalloc is implemented on top of HeapAllocO; that 
wasn’t so clear for NT, however. 


Listing 2: commit.cpp — Testing reserve/commit 
policy 


#include <assert.h> 

//include <stdio.h> 

//include "alloc.h" 

I void main(void) 

I 1 

void* Ptrs[4096]; 
i nt NPtrs - 0; 

I DWORD ReservedO, CommittedO, Reserved, Committed; 

DWORD Initial Res, InitialCommit; 

ReservedO - MemStatst &CommittedO); 

AllocInitO: 

Reserved - MemStatstSCommitted); 

printf("initializing 'Us' reserved Ox%08X bytes, committed 0x%08X\n", 
MALLOC_NAME, Reserved-ReservedO, Committed -CommittedO); 

Initial Res - Reserved; InitialCommit - Committed; 

assert((Ptrs[NPtrs++]-MALLOC(16*4096)) !- 0); 

Reserved - MemStatst&Committed); 

I printf('"%s' (16pages) reserved Ox%08X bytes, committed 0x%08X\n”, 


MALL0C_NAME, Reserved-ReservedO, Committed-CommittedO); 

ReservedO - Reserved; 

CommittedO - Committed; 
while(MemStatstO) — Reserved) 

{ 

assert((Ptrs[NPtrs++] - MALLOCf0x010000)) !- 0); 
asserttNPtrs < sizeof(Ptrs)); 

1 

Reserved - MemStats(&Committed); 
printf(”'%s' reserved 0x%08X bytes, committed 0xi08X\n", 
MALL0C_NAME, 

Reserved-ReservedO, Committed-CommittedO); 
whi1e(NPtrs > 0) 

FREE(Ptrs[--NPtrs]); 

HEAPMINO; 

Reserved - MemStats(&Committed); 
if(Committed > InitialCommit) 

printf("'%s' failed to decommit Ox%08X\n", 

MALLOCJiAME, Committed-InitialCommit); 
if(Reserved > Initial Res) 

printf(%s' kept reserved 0x%08x\n", MALLOCJIAME, 
Reserved-InitialRes); 

1 

//End of File 
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NT generally uses more space per allo¬ 
cation than Win95. Whether or not you care 
depends on your expected pattern of usage. 
The space difference is quite significant if 
you are allocating a great many tiny 
objects, but that’s a situation where a cus¬ 
tom allocator is almost always a better 
choice than one that must handle all sizes 
of requests. 

Speed 

Of course, the most obvious measure of a 
memory manager is raw speed. I used the 
same membench.cpp that I had constructed 
to measure mallocO and new, and the 
results are displayed graphically in Figure 1. 

The first thing I noticed was that the 
speed of the Win95 HeapAllocO closely 
matched the speed of Visual C++ v4.1’s 
new/delete, as measured using the bench¬ 
mark featured in the July 1996 WDJ. That 
shows why you don’t want your compiler 
vendor to define new/delete to call 
HeapAl 1 OC() — it’s nearly four times slower 
than a good, general-purpose memory allo¬ 
cator under Win95. The second thing I 
noticed is that the NT HeapAl 1 OC(), though 
less space efficient than the Win95 version, is 
approximately twice as fast. Given the num¬ 
ber of sacrifices that Win95 makes in the 
name of efficiency, I’m always bemused to 
find cases where the equivalent operation is 
actually slower in Win95 than in NT. 

IMal 1 OC was also faster under NT than 
Win95, but slower than HeapAl 1 OC () on 
both platforms. Unfortunately, I could not 
figure out from available OLE documenta¬ 
tion exactly what extra constraints IMal 1 OC 
must satisfy, so I was unable to speculate 
much on why it has to be slower or con¬ 
sume more space than HeapAl 1 oc(). 


Reserve and Commit 
Policies 

I also wanted to discover some indica¬ 
tion of how these two memory allocators 
interact with virtual memory. How much 
virtual memory do they request from 
VlrtualAllocO at a time? Do they com¬ 
mit all that memory in one fell swoop or 
incrementally? Can you force them to 
return unused virtual memory to the operat¬ 
ing system? 

The compiler benchmark I borrowed 
this time was commi t. cpp (Listing 2), which 
attempts to measure how the amount of 
reserved and committed virtual memory 
changes as memory is allocated. I ran it 
against IMal 1 oc and HeapAllocO under 
both Win95 and NT 4.0. Rather than display 
all the benchmark output, I will just summa¬ 
rize the results here. Note that these bench¬ 
marks measure only a single point in time. 
For example, it’s possible that the allocators 
use a complex algorithm to dynamically 
determine how much memory to reserve or 
commit at a time. Even given that uncertain¬ 
ty, however, I find it helpful to have a feel 
for what some typical behavior looks like. 

Under Win95, IMal 1 oc and HeapAl 1 oc() 
displayed almost the same reserve and 
commit policies, reinforcing my suspicion 
that IMal 1 OC is implemented using 
HeapAllocO. Under Win95, both memory 
managers initially reserved 1Mb of virtual 
address space, but appeared to commit 
memory only as needed. After exhausting 
the first 1Mb, both memory managers 
under Win95 reserved another 4Mb of vir¬ 
tual address space. That sounds like a lot, 
but remember that your Win32 process has 
about 1000Mb of virtual address space to 
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allocate from, and reserving addresses 
costs no space in the swap file (and only a 
small amount of physical memory for 
housekeeping). Still, I would definitely 
think carefully (and probably do another 
benchmark) before designing a program 
that used HeapCreate( ) to create hundreds 
of separate heaps. 

Under NT, HeapAl 1 oc() reserved only a 
small amount of space when the heap was 
created, and waited until the first allocation 
request before reserving 1Mb of virtual 
address space. After that 1Mb was exhausted, 
HeapAl 1 OC() next requested 2Mb. The NT 
version of I Mai 1 OC was similar, but asked for 
only 1Mb after the first was used up. As with 
Win95, the NT allocators appeared to com¬ 
mit memory only as needed, so the rather 
large amount of virtual address space being 
reserved really has only a small impact on 
your process’s resources. 

In all cases, the allocators appeared to 
properly decommit memory when request¬ 
ed by calling either HeapCorripact () or 
IMalloc- >HeapHini mi ze( ).However,they 
all appeared to hang on to the virtual 
address space that was no longer needed. 


That raises a note of caution for programs 
that run a long time and have transient 
needs for large amounts of memory, a cate¬ 
gory that some server-side software fits 
into. If you wrote a server that used sepa¬ 
rate threads and separate heaps to service 
requests, and if some of those requests 
could use very large amounts of memory, 
the separate heaps could end up exhausting 
virtual address space, due to unfreed virtual 
addresses. As a rough rule of thumb, I 
would become cautious whenever the num¬ 
ber of separate IMall oc or HeapAl 1 oc() 
heaps in a program multiplied by the max¬ 
imum expected lifetime memory usage per 
heap exceeded 100Mb (keeping in mind 
the assumption that the least a heap will 
use is 1Mb). You might think no one would 
ever create more than a few heaps in a sin¬ 
gle program, but Richter’s popular book 
Advanced Windows actually encourages 
programmers to create a separate heap for 
each C++ class; as with any Win32 feature, 
heaps can be abused. If you really want to 
create lots of separate HeapAl 1 oc ()-style 
heaps in your program, you might consider 
whether you can create them as fixed-size 


rather than as growable heaps. This will 
prevent HeapAl 1 oc () from reserving large 
amounts of virtual space that you will 
never use. 

Summary 

IMall OC and HeapAlloc() get used in a 
lot of Win32 programs, so it’s worth taking 
the time to get a feel for how they work. 
Most compilers offer a new or mallocO 
that is significantly more efficient than 
these two allocators, but you can’t use 
mallocO for everything. If you’re coding 
an OLE object that passes strings to other 
OLE objects you didn’t write, you pretty 
much have to use I Mai 1 OC. And if you are 
writing a DLL that needs to allocate 
memory that any other DLL can free cor¬ 
rectly, HeapAl 1 0C( ) is a good solution, 
especially since every process already has 
a heap associated with it that you can use. 
For casual use, both allocators work fine. 
When you start to push their boundaries, 
however, you need the sort of information 
that only benchmarks can provide. □ 

. . .. 
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More C/C++ Memory Management 


•' JIMi 
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Benchmarks 


In the July 1996 WDJ, I used some simple benchmarks to compare the memory manage¬ 
ment packages of several C++ compilers. Both Borland and Microsoft have updated their 
compilers since then, and I’ve thought of some other methods for comparison, so I decided 
to cover the topic again. If you’re not already familiar with the basics of Win32 memory 
management, you may want to start with the accompanying article “Benchmarking 
HeapAl 1 oc () and I Mai loc” on page 6 of this issue.” 

I got a fair number of reader suggestions about the previous benchmark, but they tended 
to fall into two categories: suggestions that did not substantially alter the outcome of the 
benchmark, and suggestions that simply would have ended up measuring some other aspect 
of memory management. (I’ve kept the basic speed benchmark from the previous article 
largely intact, both because I think it’s a reasonably simple measure of efficiency, and so that 
I can easily check to see if Borland or Microsoft have made substantive improvements since 
last time.) (That’s especially important in the case of Microsoft, since their Visual C++ v4.1 
memory allocation was so much worse than any other compiler’s.) I’ve written new code to 
satisfy my curiosity about a couple of other aspects of each compiler’s memory manage¬ 
ment. I hope to answer the follow questions about your favorite Win32 C/C++ compiler’s 
memory management library functions: 

• How fast is new/del ete for memory management? 

• How fast is mall oc ()/f ree() for memory management? 

• When is virtual memory ever freed up? 

• How many bytes of overhead does each allocation use? 

• How is allocated memory aligned? 

Preliminary Thoughts 

I should first point out that for the vast majority of programs, it really doesn’t matter how 
bad your compiler’s memory management package is — most Windows programs simply 
don’t have stringent memory requirements. By way of proof, I offer the example of Visual 
C++; various incarnations of that compiler have shipped with absolutely terrible implemen¬ 
tations of mall 0C() and new (very slow, very wasteful of memory), but hundreds of applica¬ 
tions have used those packages with no visible ill effects. If your application only performs 
a few thousand calls to the memory manager, it probably is not worth your while to worry 
about whether it is slow or if it wastes space. 

Win32 is even more forgiving of bad memory management than Windows 3.x. Your 
application gets nearly 2Gb of virtual addresses to play with. (If you think that should be 
4Gb, try calling ma 11 OC () in a loop and see how much you get.) And, you can reserve a 
range of addresses (which uses no space in the swap file) and then only commit them (occu¬ 
py swap file space) when you actually need them. In fact, my tests revealed that one compil¬ 
er (inadvertantly, I assume) reserves 64Kb of virtual addresses for every 32Kb that you allo¬ 
cate. Even though programs written using this compiler may be wasting virtual addresses 
like the dickens, most programmers would never notice, since the wasted addresses use no 
space in the swap file, and since even when you waste half of the virtual address space you 
still have almost 1Gb — a limit most programs will never encounter. 

However, sooner or later you may have to write a Win32 program that does have serious 
memory management demands. Perhaps you will need to allocate very large memory seg¬ 
ments to manipulate large bitmaps, or perhaps you will need to create many thousands of 
small C++ objects as part of a complex simulation. When you start to place significant stress 
on your compiler’s memory manager, you will then need to know some basic facts about 
how it works. You won’t find much help in your compiler’s documentation, however. For 
example, suppose you are writing an application that makes intensive use of floating-point 
data and you want to make sure each double is aligned on an eight-byte boundary. Does 
your compiler’s ma 11 oc() return memory aligned on eight-byte boundaries? All you’re like¬ 
ly to find in the documentation is a nebulous statement like “the return value is guaranteed to 
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be suitably aligned for storage of any type of object” (quoted from 
the Visual C++ v4.2 documentation). 

I set out to test the latest shipping versions of four different 
C/C++ compilers: Microsoft’s Visual C++, Borland C/C++, 
Symantec C++, and Watcom C++. I had intended to also include 
IBM’s Visual Age C++ for Windows, but some installation prob¬ 
lems cropped up that I was not able to solve after a few hours of tin¬ 
kering, so I eventually excluded that compiler. 

I remained committed to using “black-box” tests that assumed 
little or no knowledge of the implementation details of any particu¬ 
lar compiler. You could argue that there’s more information to be 
had by studying the source code of each compiler’s memory man¬ 
agement library, but source code can be misleading, and it’s not 
easy to prove that the source code the vendor shipped is exactly the 
same as the source code that produced the object code they shipped. 
My last article’s black-box tests turned up a bug in one compiler’s 
memory management, and this article turns up another one; both are 
bugs I would not likely have found by studying the source code. 

malloc() Basics 

The benchmarks included here focus on two types of memory 
manager: mallocO and new. However, both types face similar 
design issues, and new is often implemented with calls to ma 1 loc(). 
Before reading about the benchmarks, it’s worth reviewing the basic 
issues involved in designing ma 11OC(). 

Like most operating systems, Win32 offers a basic set of func¬ 
tions for allocating and freeing memory: the Vi rtualAl loc( ) fami¬ 
ly of functions. In general, the API that an operating system pro¬ 


vides for allocating memory is not a good choice for casual use. The 
operating system functions may be fairly slow, since they must deal 
with issues such as allocating swap file space. The operating system 
API may also be inconvenient; Vi rtual A1 1 OC() and company deal 
only in 4,096-byte pages (on Intel machines), and you wouldn’t 
want to allocate 4,096 bytes for a 256-byte structure. It is tradition¬ 
al to build a memory allocator that works on top of the operating 
system API, allocating memory from the operating system infre¬ 
quently and in large chunks, and then suballocating from those 
chunks to the calling program as needed. 

Many algorithms for memory management are possible, but 
most mallocO implementations are somewhat similar. They typi¬ 
cally maintain a linked list of free memory segments. Initially, the 
list consists of one large free block (the first big block allocated 
from the operating system). A call to mallocO then traverses the 
linked list, looking for a segment large enough to satisfy the caller’s 
request. If a large enough segment is found, it is removed from the 
list and returned to the caller. (Any leftover bytes at the end of the 
segment form a new free segment.) If no existing free segment is 
large enough to satisfy the caller’s request, mallocO allocates 
another block from the operating system and links it into the free 
list. A call to f ree( ) returns the segment to the free list. 

Notice that I’ve mentioned allocating large chunks of memory 
from the operating system, but have said nothing about returning 
them. There are three possibilities: an implementation of mall OC () 
might simply never bother to return memory to the operating sys¬ 
tem, or it might implicitly return memory as a result of some other 
call (for example, freed might try to detect that it just freed the last 
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segment in a chunk), or it might require you to call an explicit func¬ 
tion to return any unused memory to the operating system. Most of 
the compilers benchmarked here made the latter choice, requiring 
you to call an explicit function (usually named _heapmi n()) if you 
want to return any unused memory chunks to the operating system. 

Unlike most RISC processors, the Intel family of CPUs does not 
(by default) raise an exception when asked to access misaligned 
data (e.g., a four-byte integer on an odd-byte boundary). Intel CPUs 
do, however, operate more slowly in the face of misaligned data. So, 


there is considerable leeway for the designer of a Win32 trial 1OC () 
regarding how returned addresses should be aligned. As you will 
see, not every implementor made the same choice. 

In most implementations of mal 1 OC(), there is some space over¬ 
head for each allocated segment; this is known as “internal fragmenta¬ 
tion.” That is inevitable for mallocOs that decide to enforce any 
degree of address alignment. For example, if a particular mallocO 
guarantees that all returned pointers will be aligned on an eight-byte 
boundary, than a mal 1 0C() of a single byte will, by definition, waste 


Listing 1: alloc.h — Header file for supporting 
functions 


/* alloc.h - control which allocator is used. 

* 

* This header file is included by programs that want to test 

* against various memory allocators. Such programs will call 

* the macros MALLOCO and FREED rather than a specific allocator. 

* This header file expands those macros based on how you set 

* two command-line options: 


* /DALLOCATOR—1 <- use 

* /DALLOCATOR—2 <- use 

* /DALLOCATOR—3 <- use 

* /DALLOCATOR—4 <- use 

* 

* To use this header file 

* sure to call A11oclnit( 

* and FREED. A HEAPMIND 

* expands to -1 (failure) 

* it. You must also link 
*/ 


compiler's standard mallocO/freeO 
compiler's standard new/delete 
OLE's IMallocO interface 
Win32's Heap management functions 

you simply ((include it and then make 
) before performing any calls to MALLOCO 
function is also provided, though it 
for those environments that don't support 
with alloc.obj, which contains AllocInitO. 


((include <stdlib.h> 
((include <objbase.h> 
((include <windows.h> 


/* for IMalloc interface */ 


int Alloclnit(void); 
DWORD MemStatstDWORD*); 
DWORD MemAvai 1 (voi d); 
void* GetMemtDWORD Size); 


void 

void* 


DummyFree(void* Foo); 
DummyMal 1oc(size_t Size); 


extern HANDLE 
extern IMalloc* 


MyHeap; 

OleAlloc; 


((if ! defined (ALLOCATOR) 

(( error Set ALLOCATOR to 
((elif ALLOCATOR—1 

# define ALLOCINITO 

(( define MALLOCJAME 

(( define MALLOC 

(( define FREE 

(( if defined!_BORLANDC_) 

(( define HEAPMIND 

# elif defined( WATCOMC 

# define HEAPMIND 

(f else 

/( define HEAPMIND 

(( endif 

((elif ALLOCATOR—2 
(( define ALLOCINITO 

(( define MALLOCJAME 

(( define MALLOC(size) 

(( define FREE(p) 

(f define HEAPMIND 

(felif ALLOCATOR—3 
#( define ALLOCINITO 

# define MALLOCJAME 

(( if defined cpiusplus 

(( define MALLOC(size) 

(( define FREE(p) 

(( define HEAPMIND 

(( else 

# define MALLOC(size) 

(( define FREE(p) 

(( define HEAPMIND 


April 1997 


a value defined in alloc.h 
( 1 ) 

"mallocO" 
malloc 
free 

/* Borland doesn't need a heapminO*/ 
( 0 ) 

) /* Watcom uses a different name */ 

(JeapshrinkO) 

(JeapminO) 


( 1 ) 

"operator new" 

((void*)new chartsize]) 

(delete!] p) 

(JeapminO) 

A11oclnit() 

"OLE IMalloc" 

01eAl1oc->Al1oc(size) 

01eAl1oc->Free(p) 

(01eAl1oc->HeapMinimize(), 0) 

01eAl1oc->lpVtbl->A11oc(01eAl1oc, size) 

01eAl1oc->lpVtbl->Free(01eAl1oc, p) 

(01eAl1oc->lpVtbl->HeapMinimize(01eAl1oc), 0) 


(( endif 

((elif ALLOCATOR—4 
(( define ALLOCINITO 

(( define MALLOCJAME 

(( define MALLOC(size) 


A11oclnit() 

"Win32 HeapAllocO" 

(HeapAUoctMyHeap, \ 

HEAPJ0_SERIALIZE, size)) 
(HeapFree(MyHeap, HEAPJ0_SERIALIZE, p)) 
(HeapCompact(MyHeap, HEAPJ0_SERIALIZE)) 


(( define FREE(p) 

(f define HEAPMIND 

(fel se 

(( error Set ALLOCATOR to a value defined in alloc.h 
((endif 


((if defined!_SC_) 

(( define C0MPILERJAME "Symantec" 

((elif defined!_BORLANDC_) 

(( define C0MPILERJAME "Borland" 
((elif defined!JSCJER) 

(( define COMPILERJAME "Microsoft" 

((elif defined(_WATCOMC_) 

(( define COMPILERJAME "Watcom” 
((else 

(( define COMPILERJAME "Unknown" 
((endif 

/* End of File */ 
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seven bytes. A particular algorithm may also require other kinds of 
overhead for each allocated segment (e.g., a field that contains the 
size of the segment). The degree of internal fragmentation becomes 
important when your program allocates many small objects. For 
example, if you know that your compiler’s mall oc () has an average 
overhead of eight bytes per allocation, and that your program may 


allocate a great many eight-byte objects, you can cut your memory 
usage in half by using a simpler allocator built specifically for fixed- 
size allocations. 

In summary, there are a handful of interesting parameters you 
might like to know about your compiler’s implementation of ma 11 OC () 
or new. Armed with that knowledge, you have a better chance of 


Listing 2: alloc.cpp — Support code for memory 
benchmarks 


//include <assert.h> 

//include "alloc.h" 

//if definedt_BORLANDC_) 

// pragma argsused 
//endif 

void DummyFreetvoid* Foo) 

{ 

1 

//if defined!_BORLANDC_) 

i // pragma argsused 
//endif 

void* DummyMal1oc(size_t Size) 

t 

■ return 0; 

1 

HANDLE MyHeap; 

: IMalloc* OleAlloc; 


//if ALLOCATOR—3 || ALLOCATOR—4 
int Alloclnit(void) 
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{ 

MyHeap - HeapCreate!HEAP_NO_SERIALIZE. 1024, 0); 
assert(MyHeap !- NULL): 

CoGetMallocd, MleAlloc); 
assert(01eAlloc !- NULL); 
return TRUE; 

} 

//endif 


void* GetMem!DWORD n) { 

return VirtualA11oc(0, n, MEM_RESERVE, 

PAGE_READWRITE); 

1 

static void FreeMem!LPVOID P) 

{ assertfVirtualFreetP, 0, MEM_RELEASE) !- FALSE); } 

/* figure out how much memory is available */ 

DWORD MemAvailO 
1 

int i - 0; 

DWORD Avail - 0; 

DWORD Size - 4096*0x40000; 

LPVOID Ptrs[4096]; 

memsetIPtrs, 0, sizeof(Ptrs)); 

whi1e(Size >- 4096) 

( 

whi1e((Ptrs[i] - GetMem(Size)) !- 0) 

{ 

Avail +- Size; 

++i; 

assert!i < 4095); 

} 

Size /- 2; 

1 


for(i - 0; Ptrs[i]; ++1) 
FreeMem(Ptrs[ij); 


return Avail; 
1 


/* figure out how much memory is available */ 
DWORD MemStats(DWORD* PCommitted) 


{ 

MEM0RY_BA$ I CONFORMATION 

DWORD 

DWORD 

DWORD 

DWORD 


Info; 

Address - 0; 

MaxAddr - OxFFFFFFFF; 

Reserved - 0; 

Committed - 0; 


for!;;) 


VirtualQuery((LPVOID)Address, &Info, sizeof(Info)); 
ifdnfo.State !- MEM_FREE) 


Reserved += Info.RegionSize; 
ifdnfo.State — MEM_COMMIT) 

Committed +- Info.RegionSize; 


if((MaxAddr - Address) <- Info.RegionSize) 
break; 
else 

Address +- Info.RegionSize; 

1 

if(PCommitted) 

‘PCommitted - Committed; 
return Reserved; 

1 

//End of File 


• windows developer’s journal • www.wdj.com • 


18 


April 1997 



































AT&T UNIX • BANYAN • INTERACTIVE UNIX • LINUX • MOTOROLA BBOPEN • QNX 


PLATFORMS: WINOOWS NT • WINDOWS 35 • OS/S • NLM • DOS 






You can’t 
find a better 
client SDK with 
these features on 
the market! 

Over sixteen years of proven 
reliability and performance. 

No one else supports over 30 
platforms in this price renge! 


Q: What does it take to 
deploy a superior 
client/server application? 

A: A SUPERIOR SERVER 

START with the most advanced client-side SDK on 
the market: c-tree® Plus at $895. 

• Complete “C” Source code • Powerful features like 

• ROYALTY FREE (Client Side) transaction processing 

• Multiple supported protocols • Win95, NT, and 

• Fast, portable, reliable Windows 3.1 ready 

ADO a strong, multi-platform, industrial-strength 
Server that supports. 

• File mirroring • Multi-threaded design 

• Heterogeneous networking • Best price/performance 

• Automatic disaster recovery available: from $445- $3745 

RESULT? A solid, economical, easily deployable 
product that fits your needs. 

• Portable • Flexible 

• Scalable • Easy Server distribution 

• Exceptional Performance • Convenient OEM terms 


c-tree Plus 3 


FairCom Server 3 


After 16 years, still the best in single-user, multi-user and 
client/server development. Now available for Windows 
3.1, Win95, and Windows NT. c-tree Plus is still 
distributed in complete C source code and is known for 
its unparalleled flexibility, portability and royalty-free 
licensing policy. This licensing puts your development 
budget to work for you. 

• Complete C Source 

• Single/Multi User 

• Client/Server (optional) 

• Full ISAM functionality 

• No Royalties 

• Transaction Processing 

• Fixed/Variable Length Records 

• High Speed Data/Index Caching 

• Batch Operations 

• File Mirroring 

• Multiple Contexts 

• Unsurpassed Portability 


Many major companies have turned to FairCom to implement their client/server 
systems. FairCom Servers adhere to the latest client/server design principles. FairCom 
Servers communicate using NETBIOS, SPX, TCP/IP, AppleTalk, shared memory, 
Message Queues or StreetTalk, depending upon the server platform. Most server 
platforms support more than one protocol, providing you the flexibility to choose how 
your client applications communicate to the server. For example, the FairCom OS/2 
Server can communicate with shared memory, NETBIOS, SPX, and TCP/IP clients at 
the same time. No one else offers these features and portability for the price: 

• Client/Server Model _ _ _ 

• Transaction Processing FAIRCOM Server* 

• Requires <2MB RAM 

• Online Backup 

• Disaster Recovery 

• Rollback - Forward 

• Anti-Deadlock Resolution 

• Client-side "C" Source 

• Multi-threading 

• Heterogeneous networking 

• File Mirroring 

1 OEM/Source Available 4535 UNIX 


DUMB 


DOS 



Heterogeneous TCP/IP Network 

FOR YOUR NEXT PROJECT CALL FAIRCOM: YOU CANT FIND A BETTER HETEROGENEOUS CLIENT/SERVER SOLUTION! 



FAIRCOM 

CORPORATION 


Also inquire about these FairCom products: 

d-tree™ r-tree® ODBC Driver 

WWWeb Address: http://www.faircom.com/ 


U.S.A. 4006 W. Broadway - Columbia, MO 65203-0100 • phone (573) 445-6833 fax (573) 445-9698 
EUROPE Via Patrioti, 6-24021 Albino (BG) - ITALY • phone (035) 773-464 fax (035) 773-806 
JAPAN IKEDA Bldg. #3,4f-112-5, Komei-chou - Tsu-city,MIE 514 Japan • phone (0592) 29-7504 fax (0592) 24-9723 


C8003234-8180 


• HP9QOO • RS/BOOO • SUN O/S A.X • SUN O/S 5.X • MIPS ABI (SGI) • 


□ Request Reader Service #115 □ 


APPLE A/UX • LYNX • SCO • SYSTEM MANAGER • SUN SPARC-SOLARIS • IBM RS/ 

















Listing 3: align.cpp — Benchmark of allocator align¬ 

ment 


I /* align.c - figure out how this allocator aligns its memory 

l */ 

' ♦include <stdio.h> 

♦include <stddef.h> /* for offsetof */ 

♦include "alloc.h” 

| #include <windows.h> 

/* biggest alignment any sane allocator would enforce */ 
♦define BIGGEST_ALIGN (4096) 

♦define DEFINEALIGN(type) \ 

1 typedef struct type#ALIGN \ 

1 { \ 

: char Fool[l]; \ 

| type Member; \ 

} type##ALIGN; 

f DEFINEALIGN(int); DEFINEALIGN (1 ong ) ; 

{ DEFINEALIGN(float); OEFINEALIGN(double); 

I struct Tiniest { 

char PeeWeeCl]: 

I ); 

| int A1ignment(void* P) 

I 1 

| long Target - (long)P; 

! int 1; 

ford - BIGGEST.ALIGN: i > 0; 1/-Z) 

{ 

if(!(Target % i)) 
return i; 

} 


knowing when it might be worth your while to build a custom memo¬ 
ry allocator for a particular program, and when the package that comes 
with your compiler will work just fine. The rest of this article attempts 
to supply some hard numbers that provide that knowledge. 

Testing Tools 

My benchmarks consist of small individual programs, and they 
have enough in common that I decided to create a small file of support 
code, alloc.h (Listing 1) is a set of definitions that all my benchmark 
programs include. Because I am testing more than one type of memo¬ 
ry manager (e.g., both new andmalloc()), this header file abstracts the 
memory management interface into three macros: MALL0C(), FREE(), 
and H EAPMI N (). To recompile a particular benchmark so that it mea¬ 
sures a different memory manager, you simply define the macro 
ALLOCATOR to have one of four values. For example, compiling with 
the option “-DALLOCATOR=2” causes MALLOCO to expand into a 
call to the global new operator. Besides mal 1 oc() and new, the macros 
here can also expand into calls to the OLE memory manager and the 
Win32 heap memory manager; that functionality is used in the accom¬ 
panying article “Benchmarking HeapAUoc() and IMalloc” on page 6. 

alloc.cpp (Listing 2) provides various support functions. 
ALLOC I NIK ) performs initializations necessary before calling OLE 
or Win32 heap functions; it is not relevant to this article. The low¬ 
est-level memory management in Win32 is provided by the 
Vi rtual A1 1OC() family of functions. I used brute-force methods to 
detect how the code being tested was allocating memory from the 
operating system. For example, to detect when Vi rtual All oc() 
was being called, I would first check the amount of free memory, 
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then call mal 10C(), then check again. Whenever the amount of free 
virtual memory had changed, I knew that the call to mal 10C() had 
resulted in a call to VirtualAl 1OCC). The function MemAvailO 
implements this crude check for me; it calculates the amount of free 
(unreserved) virtual memory by calling VirtualAllocO until it is 
all used up, after which it frees all the memory it allocated. Another 
function, MemStats(), uses Vi rtual Query() to determine both the 
number of reserved and the number of committed pages. Both these 
functions are quite slow, but I was able to speed things up somewhat 
by first allocating most of the virtual address space. The functions 
GetMemO and FreeMemO are simply wrappers for allocating and 
freeing pages of virtual memory. 


Alignment 

My first benchmark merely measures the alignment of the mem¬ 
ory allocator under test. There’s really no way to know for sure what 
alignment a memory allocator produces without examining the 
source code. In practice, however, a crude algorithm can provide the 
answer with a high degree of confidence. 

My idea for checking the alignment of allocated memory address¬ 
es was to simply allocate many different memory segments and keep 
track of the least-aligned pointer returned. As I was using such a 
scheme to check alignment, it occurred to me that a given compiler 
might handle different memory sizes with different algorithms, so I 
revised my idea to check the alignment of memory at different sizes. 


Listing 3: align.cpp — continued 


return BIGGEST_ALIGN; 

} 

int HowIsAtigneddnt Size) 

{ 

void* Pt rs[1024*23; 
int i. Align, NewAlign; 

Align - BIGGEST.ALIGN; 
for(i-0; i < 1024; ++1) 

{ 

Ptrs[i*2] - MALLOC(Size): 

NewAlign - Alignment(Ptrs[i*2]); 
Ptrs[i*2+1] - MALLOC(i); 
if(NewAtign < Align) 

Align - NewAlign; 

} 

forti-0: i < 1024; ++i) 

{ 
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FREE(Ptrs[i*2]); 

FREE(Ptrs[i*2+l]); 

) 

return Align; 

1 

void main!) 

{ 

int IntAlign, LongAlign, FloatAlign, DoubleAlign; 
int Align - BIGGEST.ALIGN; 
int OldSize - 1; 
int WorstAlign; 

int Size; 

ALLOCINITO; 

WorstAlign - Align - HowIsAligned(01 dSize); 
for(Size—2; Size <- 1024; ++Size) 

{ 

int NewAlign - HowIsAl1gnedCSize); 
printf/* let me know it's alive... */ 
if(NewAlign !- Align || Size — 1024) 

{ 

if(Size > OldSize+1) 

printf("\n*d through li -byte segments aligned at <M\n”, 
OldSize, Size-1, Align); 

else 

printf("\n%d-byte segments aligned at %d\n", 

OldSize, Align); 

OldSize - Size; 

Align - NewAlign; 
if(NewAlign < WorstAlign) 

WorstAlign - NewAlign; 

1 

} 

printf CDs' Aligns on id-byte boundaries\n", 

MALLOC.NAME, WorstAlign); 

IntAlign - A1ignment((void*)offsetof(intALIGN, Member)); 
LongAlign - A1ignraent((void*)offsetof(1ongALIGN, Member)); 
FloatAlign - A1ignment((void*)offsetof(floatALIGN, Member)); 
DoubleAlign - A1ignmentl(void*)offsetof(doubleALIGN. Member)); 

if(IntAlign > Align) 

printfCBut ints are aligned at id!\n”, IntAlign); 
if(LongAlign > Align) 

printfCBut longs are aligned at %d!\n", LongAlign); 
if(FloatAlign > Align) 

printfCBut floats are aligned at id!\n”, FloatAlign); 
if(DoubleAlign > Align) 

printfCBut doubles are aligned at id!\n”, DoubleAlign); 
if(sizeof(struct Tiniest) > Align) 

printfCBut the minimum struct size is Ud!\n", DoubleAlign); 
printfCThis test compiled with '%s'\n", COMPILER.NAME); 

} 

//End of File 


Table 1: 

malloc() alignment results 


Compiler 

Time 

Alignment 

Misalignment 

Microsoft 

88.7 

16(1-480) 

4(481-1024) 

doubles (8) 

Borland 

33.1 

4 

none 

Symantec 

12.9 

4 

doubles (8) 

Watcom 

12.1 

8 

none 
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To do that, I use a loop that allocates the same memory size over and 
over, but between each iteration, I also allocate a varying size of 
memory to increase the odds of encountering all possible align¬ 
ments. I only tested sizes up to 1,024 bytes. 


align.cpp (Listing 3) contains my alignment benchmark. 
HowIsAlignedO detects the worst alignment for a given size of 
memory allocation, align.cpp also checks the default structure 
alignment of the given compiler for various kinds of data members. 


Listing 4: membench.cpp — Benchmark of allocator 
speed 


♦include <assert.h> 
♦include <windows.li> 
♦include <stdio.h> 
♦include "alloc.h" 
♦include <time.h> 


printf( "Time - £d.£d\n", Secs, Decs): 

printf< "memory time-£ld. loop time-£ld\n". TotalTime, LoopTime): 
) 

} 

void mainlint argc, char**argv) 

{ 

ALLOCimTO; 


♦define CPS ((int)CLOCKSJ>ER_SEC) 
long NIterations; 

int NBlocks; /* total number of memory blocks to allocate */ 

int MinBlockSize; /* minimum block size to allocate */ 

int MaxBlockSize; /* maximum block size to allocate */ 

int DummyCount; // so no one can optimize my dummies away 

void BenchMark(void) 

{ 

clock_t StartTime, StopTime, LoopTime. TotalTime: 

long i; 
void** Pointers: 
int* Sizes; 

/* first, create array of pointers */ 

Pointers - (void**)calloc(NBlocks, sizeof(void*)); 

Sizes - (int*)calloc(NBlocks. sizeof(int)): 

/* second, initialize sizes to random values */ 
forti—0: i < NBlocks: ++i) 

( 

int Size - randO £ ((MaxBlockSize-MinBlockSize) + 1): 

Size +- MinBlockSize: 

Sizesti] - Size; 

) 

/* third, measure basic loop time */ 

StartTime - clock!): 

forCi - 0; i < NIterations; ++i) 

{ 

int iBlock - i £ NBlocks; 

if(Size$[iBlock]Sl) II randomly call dummy free or malloc 
{ 

DummyFreelPointers[iB1 ock]); 

PointerstiBlock] - 0; 

1 

else 

PointerstiBlock] - DummyMalloc(Sizes[iBlock]): 

} 

StopTime - clock!): 

LoopTime - StopTime - StartTime; 

/* fourth, allocate a random set of blocks */ 
for(i-0; i < NBlocks: ++i) 
iflrandO S 1) 

Pointers[i] - MALLOCCSizesti]); 


/* finally, perform benchmark */ 

StartTime - clockO; 

for(i - 0; i < NIterations; ++i) 

{ 

int iBlock - i £ NBlocks: 
if(Pointers[iBlock]) 

1 

FREE!PointerstiBlock]); 

PointerstiBlock] - 0: 

I 

else 

PointerstiBlock] - MALLOCISizestiBlock]); 

) 

StopTime - clockO; 

TotalTime - (StopTime - StartTime) - LoopTime; 

printf("NIterations-£ld, NBlocks-Xd, MinBlockSize-£d, MaxBlockSize-£d\n", 
NIterations, NBlocks. MinBlockSize, MaxBlockSize); 

( 

int Secs - TotalTime / CPS; 

int Decs - (TotalTime-(Secs*CPS)) / (CPS/10); 



♦ifdef _WATC0MC_ 

_amblksiz - 64*1024; 

♦endif 

// assume at least, hundredths of a second resolution 
assert(CPS >- 100); 

MinBlockSize -4; 

NIterations - 1000L*1000L*5; 

if(argc — 3) 

{ 

NBlocks - atoi(argvtl]): 

MaxBlockSize - atoi(argv[2]); 

} 

if(NBlocks < 1 || MaxBlockSize < MinBlockSize) 

fprintf(stderr, "Usage: membench <4of blocks) <max block size>\n”); 

else 

{ 

printf("Benchmarking ’£s'\n", MALL0C_NAME); 

BenchMarkO; 

} 

exit(DummyCount?EXIT_SUCCESS:EXIT_FAILURE); 

) 

//End of File 
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If it finds that the default structure align¬ 
ment for a particular data type is greater 
than the alignment of the memory allocator, 
it prints out an error message. 

Table 1 shows the results of my align¬ 
ment testing. Just for fun, I also timed how 
long the alignment test took to complete 
and included that information there; you 


can’t read too much into the results, since 
the code contains I/O as well as memory 
management calls, but it does make me 
think the alignment test might make an 
interesting speed benchmark for a future 
article. Microsoft’s compiler probably per¬ 
formed poorly here because it uses 
HeapAl 1 oc() for large memory allocations. 


and HeapAllocO is very slow under 
Windows 95. 

The results for Visual C++ v4.2 were 
fascinating. It appears that the alignment of 
the returned memory is different for sizes 
above 480 bytes! VC++ also has a potential 
misalignment problem. By default, VC++ 
v4.2 aligns doubl es in structures on eight- 
byte boundaries, but its mallocO may 
return memory that is only aligned on four- 
byte boundaries. Since most structures are 
less than 480 bytes long, most of them will 
be aligned correctly. The real problem 
would be for scientific and engineering 
code that performs matrix operations on 
large arrays of doubles. If you use VC++’s 
mallocO to allocate those arrays, the data 
may be misaligned, producing a serious 
speed penalty (perhaps twice as slow on a 
Pentium, depending on the operation). 

I was unable to think of any good reason 
for this odd pattern of alignment. After all, 
why charge the space overhead of 16-byte 
alignment when it costs the most (in small 
allocations) and not charge it when it repre¬ 
sents a small percentage of the requested 
memory? My best guess would be that this 
is a bug. I finally broke down and peeked at 
the source code that comes with the com¬ 
piler. Indeed, it turns out that Visual C++ 
v4.2 mal 1 oc( ) source code divides memo¬ 
ry requests into those less than or equal to 
480 bytes and those larger; for the latter, it 
simply calls HeapAllocO, which (in addi¬ 
tion to being dam slow under Windows 95) 
happens to have a four-byte alignment. 
This does not strike me as a desirable fea¬ 
ture — you get much of the wasted space of 
16-byte alignment without really being 
able to count on getting that alignment for 
all calls to ma 11 oc 0. 

Symantec has a similar alignment prob¬ 
lem; its default structure alignment also 
places doubles on eight-byte boundaries. 
However, all allocation sizes were four-byte 
aligned with Symantec, making it much 
more likely you would actually encounter 
the structure alignment penalty. Borland 
also aligns on four-byte boundaries, but it 
does not by default align doubl es in struc¬ 
tures on eight-byte boundaries, so at least it 
was consistent. Watcom was the only com¬ 
piler whose mallocO aligned on eight-byte 
boundaries, making it possible to mal 1 0C() 
large arrays of doubl es without having to 
worry about a slowdown due to misaligned 
data. This behavior fits in with Watcom’s 
reputation as being optimized for floating¬ 
point applications. 


malloc() time 
new time 



Visual C++ v4.2 

Borland C++ v5.1 

Watcom C++ v10.6 

Symantec C++ v7. 

Vendor 


Block size 


Figure 1: C++ memory management speed 
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Basic Speed 

The source to my slightly revised bench¬ 
mark is in membench. cpp (Listing 4). Unlike 
last time, this time I used it to test two allo¬ 
cators for each compiler new/del ete versus 
mall oc( )/f reel ). If you aren’t familiar with 
C++, new and del ete are basically typesafe 
wrappers for mall oc() and freed. I tried to 
keep the benchmark extremely simple in 
order to make it easy to understand and veri¬ 
fy its validity. The program basically sits in a 
loop and randomly creates and deletes mem¬ 
ory blocks of a random size (up to a maxi¬ 
mum block size). You can control the maxi¬ 
mum number of blocks and the maximum 
block size via command-line parameters. 

For each of the four compilers, I com¬ 
piled this program to produce a 32-bit 
Windows console application. I then ran 
this program under Windows 95 on a 
133Mhz Pentium with 48Mb of physical 
memory. For each compiler, the benchmark 
was run with the following settings: 

membench 1000 32 
membench 1000 64 
membench 1000 128 
membench 1000 256 


In other words, the benchmark used a max¬ 
imum of 1,000 allocated blocks of memory, 
with a maximum block size ranging from 
32 bytes to 256 bytes. I was guessing that a 
moderately memory-intensive program 
might use around 1,000 strings, C++ 
objects, etc., and I wanted to see how speed 
varied with respect to the average size of 
memory blocks. 

The results of the benchmark are shown 
graphically in Figure 1. The biggest news is 
that Visual C++ v4.2 performed much, 
much better than previous versions. Its new 
operator now produces results in this partic¬ 
ular benchmark that are very competitive 
with the other compilers. Its mallocO 
(something I didn’t measure separately last 
time) is not quite so competitive, being 
around twice as slow as the other compilers. 

Freeing Up Memory 

As your program calls mal 1 oc( ) or new, 
the compiler runtime may have to call 
VirtualAllocO to obtain more virtual 
memory from the operating system. The 
memory you obtain from mallocO or new 
consumes both virtual addresses (of which 
your process has 2Gb to itself) and space in 


the swap file (of which your process has con¬ 
siderably less, and that it must share with 
others). Suppose that your application at one 
point allocates a great many memory blocks 
— 2Mb worth. At that point, your application 
is using up at least 2Mb worth of virtual 
addresses and 2Mb worth of committed 
space in the swap file. Now suppose that 
your application completes the operation that 
required so much memory and calls del ete 
or f ree () to free up every last memory block 
it allocated. Once the very last block is deal¬ 
located, how much virtual address space and 
swap space do you think your program is 
using? The answer depends entirely on how 
your memory manager is implemented. 

In case you think this style of memory 
management (allocate a bunch of memory, 
then free it all) rarely arises in practice, let 
me give one increasingly common example. 
Suppose you are implementing a program as 
an NT service, or as most any kind of server. 
The odds are good that your program waits 
for requests, then operates on the request and 
returns to waiting. The odds are also good 
that your program allocates memory while 
performing the request and then frees it all up 
again. If the amount of memory allocated can 
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vary greatly depending on the request, then you might be very interest¬ 
ed in the ability to return memory to the operating system when you 
are no longer actively using it Otherwise, one unusually large request 
will commit space in the swap file that will remain committed for the 
life of your application (and server applications may be expected to 
live for days or weeks). 

Most of the compilers tested here do not attempt to notice that 
you have freed up all the memory in a Vi rtual A11 oc( )-allocated 
region, so they do not automatically return virtual memory (and 
swap space) to the operating system. Instead, they require you to 
call a special function that scans internal data structures and tries to 
Vi rtuai Free() any regions that are no longer in use. 

nofree.cpp (Listing 5) is a small program I wrote that tests 
whether a memory manager implicitly returns memory to the oper¬ 
ating system. It first figures out how much virtual address space is 
available. It then allocates a lot of memory and verifies that the 
amount of virtual memory reserved has increased. Finally, it frees 
the entire linked list and remeasures the amount of virtual address 
space available. 

The results of this measurement don’t require a table: Borland is 
still the only compiler that automatically returns (both decommits 
and unreserves) virtual memory to the operating system on your 
behalf. Visual C++ v4.2 provides a_heapmi n () function; it does not 
return virtual address space to the operating system, but it does 
decommit pages where possible, which is the most important thing. 
In fact, the VC++ v4.2 memory manager appears to decommit 
empty pages implicitly on the fly as you call freel), so you may 
not need to call _heapmin(). Symantec documents a _heapmin() 
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function, but the linker could not find it in the appropriate libraries, 
so I was unable to perform this test with Symantec. Watcom does 
not free memory implicitly, but it does have a _heapshri nk() func¬ 
tion that does the job correctly (note that the Watcom C++ vl0.5 
version of this function did not work). 

Internal Fragmentation 

Last time I performed these benchmarks, I wished for a way to 
measure internal fragmentation — the amount of space overhead for 
each memory allocation. For example, suppose that you use Visual 
C++’s mal 10C() to allocate a single byte of memory. From previous 
benchmarks, you know that the returned address will be aligned on a 
16-byte boundary, so it’s likely that mal 10C() had to waste at least 15 
bytes for that allocation just to make the alignment work. A memory 
manager may also have to use extra bytes to store an associated size 
field, or link fields. When you are using a memory allocator to allocate 
a great many small (say, less than 64 bytes) objects, it’s worth knowing 
what the internal fragmentation is, since it could amount to a quite sig¬ 
nificant space penalty. In general, the internal fragmentation may vary 
somewhat depending on the size of the allocation request, so it would 
be helpful to measure this number for various allocation sizes. 


Listing 5: nofree.cpp — Test ability to free memory 


#include <malloc.h> 
finclude "alloc.h” 

finclude <assert.h> 
finclude <windows.h> 
finclude <stdio.h> 
finclude <stdlib.h> 

| 

void main() 

( 

void* Ptrs[1024] : 

DWORD StartRes, StartComj; 

DWORD BigRes, BigCom; 
int i; 

StartRes - MemStats(SStartCom); 

printf("Start: 0xM8X Reserved, 0xM8X Committed\n", 

StartRes, StartCom); 

// now use up at least BIGALLOC Mb of memory 
ford - 0; i < 1024; +ri) 

assertf(Ptrsfi3 = MALL0C(1024*4+rand()%512)) !- 0); 

BigRes - MemStatsUBigCom); 

printft"Middle: 0x*08X Reserved, OxMBX Committedin". 

BigRes. BigCom): 
asserttBigRes > StartRes); 

ford - 0; i < 1024; +H) 

FREE(Ptrs[iI); 

1 

! 

BigRes - MemStatsUBigCom); 

printft"End: 0x*08X Reserved, 0x%08X Committed\n”. 

BigRes, BigCom); 

if(BigRes <- StartRes 88 BigCom <- StartCom) 

printf(”%s implicitly frees memory\n", COMPILERJtAME); 
HEAPMINO; 

BigRes - MemStats(SBigCom); 

printf("Final: 0x%08X Reserved, 0x*08X CommittedVn", 

BigRes, BigCom); 
if(BigCom > StartCom) 

printf("%s does not decommit memory!\n", C0MPILER_NAME); 

| if(BigRes > StartRes) 

printf("%s does not free memoryUn”, C0MPILER_NAME); 

i //End of File 
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The problem is, how can a simple program measure this aspect 
of a memory manager without knowing any of its implementation 
details? After thinking about it a while, I hit upon a brute-force 
scheme I thought might work. All Win32 memory managers eventu¬ 
ally have to call VirtualAllocO to obtain more memory. If you 
assume that they will not call Vi rtual A1 1 oc () until they’ve used up 
all their existing memory, then there is a way to indirectly measure 
internal fragmentation. First, measure the amount of available virtu¬ 
al memory (I’ll describe how later). Second, go into a loop that allo¬ 
cates some small chunk of memory (say 256 bytes) until the amount 
of available virtual memory changes. At that exact moment, you 
know that the memory manager being analyzed has just called 
Vi rtuai A1 loco because it did not have room to allocate 256 bytes. 
That means you are starting with a fresh 
chunk of memory, which has been used 
only to satisfy a single 256-byte request. 

Next, go into a loop and allocate memory 
of the desired size until the amount of free 
virtual memory changes again. By multi¬ 
plying the number of iterations (minus one, 
actually) by the size being allocated, and 
then adding the initial 256 bytes, you know 
how many total bytes you requested. By 
measuring the change in available virtual 
memory, you know how much virtual 
memory was actually used. The difference 
between the number of bytes requested and 
the number of bytes used, when divided by 
the number of bytes requested, gives you 
the percentage of space lost due to internal 
fragmentation. 

Of course, this is a heuristic scheme and 
it could have many problems. The biggest 
problem, which became a nightmare, is that 
it can take a very long time to run this 
benchmark. It turns out that both Borland 
and Microsoft may reserve memory in 4Mb 
chunks, which means that my scheme calls 
for allocating 4Mb of memory, as little as 
one byte at a time. One way to measure the 
available virtual memory is to 
VirtualAllocO as much memory as pos¬ 
sible and see how much you get. 

Unfortunately, that’s a fairly slow opera¬ 
tion, especially if you’re talking about per¬ 
forming it a million times for single bench¬ 
mark. It took me a while to grasp exactly 
how much time all this could take — at one 
point, I was actually sleeping on my office 
floor with an alarm to wake me up every 
couple of hours so I could verify that the 
previous benchmark worked and start the 
next one. Eventually, I did some worst-case 
estimates to see how long it could possibly 
take, and then decided to look for some 
cheap and dirty alternatives. 

intfrag.cpp (Listing 6) contains the 
basic program I used, but it is not necessar¬ 
ily the precise source code used to measure 


each compiler. I couldn’t come up with an attractive alternative to 
my basic scheme, so I started tinkering with heuristics. The first 
loop (using memory until a call to VirtualAllocO occurred) was 
easy to speed up by just allocating a big chunk before entering the 
loop. Of course, the size of that big chunk really depended on the 
compiler so it required manual tinkering. 

Allocating 4Mb one byte at a time is slow, but the real killer is 
checking the amount of free memory at each iteration. Therefore, I 
inserted a variable (called Guess) that made a rough estimate of how 
many iterations would be required before the allocator would have 
to call VirtualAllocO again. I then called the allocator with the 
desired size Guess times hoping to get close to, but not actually 
over, the amount of currently allocated virtual memory. Assuming 


The Ultimate Help 
Authoring Tool" 



Introducing the new RoboHELP 4.0, the 
fastest and easiest way to create Help 
systems for Windows NT, Windows 95, and 
Windows 3.1. 


1 Click Single Source 


Sf Windows Help 
if HTML Based Help 
if Documentation 
& Web Sites 


While the competition was busy trying to get 
their help tools up to our standards, we 
quietly went and set new ones: ActiveTest 
and ActiveEdit, 1 Click Single Source, 
Documentation Wizards, WinHelp Internet 
Access, and What's This? Help Composer. 


Call us today to place your order 

BLUE SKY SOFTWARE 


wm 




1-800-718-4406 

Int’l 1-619-459-6365 
Fax 1-619-459-6366 
info@blue-sky.com 


o 


W oow; 


bvTE 


BEST SELLER 


□ Request Reader Service #110 □ 

• windows developer’s journal • www.wdj.com • 


April 1997 


27 




























that performing Guess allocations did not cause a call to 
Vi rtual A1 loc( ) (I added an assertion to check that assumption), I 
could then enter the very slow loop that had to also check the available 
free memory at each iteration. 

If all this sounds a little disreputable to you, it does to me, too. I 
didn’t like having to tinker with the benchmark for each compiler, 
as it makes it too easy to introduce an error into what is already a 
heuristic algorithm. As always, at the end of the project I had better 
ideas about how to do it next time. Although I’m not 100 percent 
confident in the numbers I obtained, I decided to go ahead and share 
them — take them with a grain of salt. 

Table 2 shows the results of attempting to measure the internal 


fragmentation for various sizes of memory allocation. I tested 
only mallocO, not new, though there’s a reasonable chance the 
results would be identical. One sanity check on this data is to ver¬ 
ify that it does not violate any information obtained from the pre¬ 
vious benchmark of alignment. In other words, since Visual 
C-h-’s mal 1 oc( ) aligns a one-byte allocation on a 16-byte bound¬ 
ary, the internal fragmentation associated with one-byte alloca¬ 
tions ought to be at least 15 bytes. I didn’t see any information in 
Table 2 that contradicted what I already know about alignment, 
which was a relief. 

The pattern for Borland’s mal 10C() looks plausible for a sim¬ 
ple linked-list allocator that aligns on four-byte boundaries. The 


Listing 6: intfrag.cpp — Benchmark of internal frag¬ 
mentation 


include <assert.h> 
include <stdio.h> 

♦include "alloc.h" 

♦include <stdlib.h> 

void DumpStats(void) 

1 

DWORD Reserved, Committed; 

Reserved - MemStatst&Committed); 

printf("Reserved—Ox%08X. Commi tted-0xM8x\n", Reserved, 

Committed); 

1 

double CalcIntFragdnt Interval) 

{ 

DWORD High, Low, Lowest, BytesAllocated, Used, Wasted; 

DWORD Granularity, NAUocs; 

DWORD ReservedO, CommittedO, Reserved, LastCommitted, Committed: 

DWORD Guess; 

/* High — highest amount of memory available in this run */ 
High - MemAvai1(); 

/* reserve most virtual memory to speed later calculations */ 
whiletHigh > OxOOFFFFFF) 

{ 

if(!GetMemCHigh/2)) 
break; 

High - MemAvailO: 

1 

printfC'Now all but 0xM8x of memory is reserved\n", 

High); 

// MALLOC(3*1024*1024); /* for those 4Mb-at-a-time malIocs! */ 

/* use up most every byte in currently-allocated pages */ 

do { 

MALLOC(1); 

1 

whileCHigh — MemAvailO); 

ReservedO - MemStats(SCommittedO); 

Granularity - High - MemAvailO; 

DumpStatsO; 

printfC'Xs reserves chunks of 0xM8X\n", MALLOC_NAME, Granularity); 

/* keep track of ♦ of bytes we've allocated */ 

BytesAllocated - 1; 

/* alloc Interval bytes at a time, until another VirtualAllocO */ 
Low - MemAvailO; 

Lowest - Low; 

ifdnterval < 1000) 

Guess - Granularity / 

(32 + ((Interval+15)/16) *16); 

else 

Guess - Granularity / (Interval *4); 

Guess — 256/Interval; 

for(NA11 ocs—0; NAUocs < Guess; ++NAllocs) 

MALLOC(Interval); 

BytesAUocated +- Guess * Interval; 
printf("Approaching slow part\n”); 


/* make sure we didn't overshoot */ 
assert(MemAvaiK) — Low); 

for(; ; ++NAUocs) 

{ 

MALLOC!Interval); 

Low - MemAvailO; 

ifUHigh - Low) > Granularity) 

/* don’t count the MALLOCO that pushed us over */ 
break; 

else 

Lowest - Low; 

BytesAUocated +-Interval; 

} 

Reserved - MemStats(&Committed); 

printfC'Reserved increased 0x%08X, Committed increased 0xM8X\n", 
Reserved-ReservedO, Committed-CommittedO); 

Used - High - Lowest; 

Wasted - Used - BytesAUocated; 

DumpStatsO; 

pri ntf ("Used—%d, Wasted-M, BytesAl I ocated-%d\n", Used, Wasted, 
BytesAUocated); 

printfC'Bytes wasted per allocation - *f\n", (float)Wasted/(float)NA1Iocs); 


♦if 0 

whi1e(NA1Iocs-- > 5) 

MALLOC(Interval); 

High - MemAvailO; 
do { 

MemStats(SLastCommitted); 
assert(MALLOC(Interval)); 

) 

whi 1 e( Hi gh — MemAvailO); 

MemStats(ACommitted); 

printfC'Reserving new block of 0x%08X causes commit of 0xM8X\n", 
High-MemAvail(), Committed-LastCommitted); 

♦endif 

return ((double)Wasted*X00.0)/(double)Used; 

) 

void main(int argc, char** argv) 

{ 

int Size; 
double Frag; 

♦ifdef _WATC0MC_ 

_amblksiz - 64*1024; 

♦endif 

ALLOCINITO; 

if(argc < 2 || (Size—atoi(argvfl])X—0) 
pri ntf ("Usage: intfrag AUocSize\n"); 

else 

( 

printf("Compi1er '%s' , using allocation size of %d\n”, 
C0MPILERJAME, Size); 

Frag - CalcIntFrag(Size); 

printfC"%s' internal fragmentation - %f%%\n", MALL0C_NAME, Frag); 

) 

} 

//End of File 
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output for Microsoft’s mallocO looks almost as plausible, if I 
assume an algorithm that uses a byte map to represent free or 
allocated 16-byte paragraphs of memory. By the time I get to 
Symantec’s output, I begin to have doubts that this pattern could 
be correct — but on the other hand, I haven’t been able to see 
where the test program could be going wrong. The next step may 
have to be analyzing the source code behind the memory alloca¬ 
tors for some answers. 

Whatever the ultimate accuracy of this test, it did immediately 
detect a problem with Watcom’s ma 11 0 C( ). When I originally ran 
the benchmark with Watcom, it always showed 50 percent or more 
space wasted on internal fragmentation. A closer look showed that 
virtual addresses were being reserved 64Kb at a time, but only 32Kb 


got committed before 

another request 

for 64Kb 

was made. 

Table 2; 

Internal fragmentation benchmark results 

Size of 
allocation 


Overhead per allocation 



Microsoft 

Borland 

Watcom 

Symantec 

1 

16 

15 

15 

7 

2 

15 

14 

14 

6 

3 

14 

13 

13 

5 

4 

13 

12 

12 

4 

5 

12 

11 

11 

11 

6 

11 

10 

10 

10 

7 

10 

9 

9 

9 

8 

9 

8 

8 

8 

9 

8 

7 

7 

7 

10 

7 

6 

6 

6 

11 

6 

5 

5 

5 

12 

5 

4 

4 

4 

13 

4 

7 

11 

19 

14 

3 

6 

10 

18 

15 

2 

5 

9 

17 

16 

1 

4 

8 

16 

17 

17 

7 

7 

15 

18 

16 

6 

6 

14 

19 

15 

5 

5 

13 

20 

14 

4 

4 

12 

21 

13 

7 

11 

11 

22 

12 

6 

10 

10 

23 

11 

5 

9 

9 

24 

10 

4 

8 

8 

25 

9 

7 

7 

7 

26 

8 

6 

6 

6 

27 

7 

5 

5 

5 

28 

6 

4 

4 

4 

29 

5 

7 

11 

35 

30 

4 

6 

10 

34 

31 

3 

5 

9 

33 

32 

2 

4 

8 

32 


Apparently, Vi rtual A110C() always reserves 64Kb of space, even 
if you ask for less, so Watcom’s mallocO was reserving 64Kb 
when it thought it was reserving 32Kb. The unused portion was 
never committed, so the only loss was virtual addresses (cutting the 
normal 2Gb available down to 1Gb). Roger Kehl of Watcom 
explained the problem to me and showed how to eliminate it by 
adding the following line of code: 

_amblksiz - 64*1024; 

That caused the allocator to request memory 64Kb at a time, and 
allowed me to go ahead and benchmark Watcom’s mallocO. 

Summary 

Benchmarks are always educational, if somewhat tedious to cre¬ 
ate and verify. I learned that Microsoft’s allocator has gotten a lot 
better, though it is still far from best. I learned that anyone doing 
intensive floating-point manipulations should think about making a 
wrapper for ma 11 OC () to avoid misaligned data, unless they’re using 
Watcom (which already provides eight-byte alignment). I learned 
that internal fragmentation can easily amount to a 100 percent space 
penalty for small objects. I learned a bit more about how 
Vi rtualAl 1 0C( ) works, and what that implies for higher-level 
memory managers. I hope to revisit this topic again after more com¬ 
piler updates arrive. □ 
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Muthuvale Shanmugam 



Horizontal Listbox Scrolling with 
MFC 

The standard listbox control (created with the WS_VSCROLL style) automatically handles ver¬ 
tical scrolling. If you insert more items than will fit in the listbox window, a vertical scrollbar 
appears, allowing the user to scroll up and down. For horizontal scrolling, however, the listbox 
expects you to provide custom code — just using the WS_HSCROLL style bit won’t do the job. You 
are responsible for keeping track of the widest string in the listbox and for sending an 
LB_SETHORI ZONTALEXTENT message to inform the listbox of the maximum horizontal scroll to 
allow. For example, if you add a single string to an empty listbox, you would calculate the width 
of that string (e.g., using GetTextExtent( )) in pixels, then pass that width to the listbox control 
via the LB_SETHORI ZONTALEXTENT message. If you then add another string, you must calculate 
its width and send another LB_H0RI ZONTALEXTENT message if it is longer than the previous max¬ 
imum width. To be user-friendly, you must also send an LB_H0RIZONTALEXTENT message after 
deleting the longest string in the listbox. Otherwise, you might end up with a horizontal scroll 
range that is much wider than any of the remaining strings. 

Since Windows doesn’t keep track of listbox string widths, programmers have to roll 
their own code. A single algorithm works for all string-based (i.e., not owner-drawn) list- 
boxes, so this is a good candidate for a reusable C++ class. This article provides an MFC 
class called CHLi stBox which, when used in place of MFC’s CLi stBox, takes care of all the 
necessary horizontal scroll logic. The public members of CHLiStBox are fully compatible 
with CLi StBox, so it can be easily plugged into existing code as well. 

LISTHORZ 

The Windows SDK online help file (in the “Programming Tips” section) provides docu¬ 
mentation for handling the listbox’s horizontal scrollbar. It also provides the sample C pro¬ 
gram LISTHORZ. CHLi stBox’s logic is similar — but not identical — to that of LISTHORZ. 
Besides being implemented in C++ and other minor differences, CHLi StBox has two major 
improvements over LISTHORZ. 

In LISTHORZ, the horizontal scrollbar manipulation logic is not completely transparent to 
the application. In CHLi StBox, the scroll logic is concealed in the private area of the class, 
making it completely transparent. 

If the widest item is deleted, the listbox may end up displaying an invalid area. To handle 
this, LISTHORZ scrolls the listbox to the left end after deleting the item, whether or not the list- 
box is pointing to a valid area. While this ensures that the listbox points to a valid area after 
deletes, it is not always convenient — the user who had been viewing the right-hand side of 
the listbox items will have to scroll back to the right again after deleting a string. CHLi stBox, 
on the other hand, contains additional logic to skip this scroll whenever appropriate. 

Using CHListBox 

You can create and use CHListBox as you would the standard MFC CLi StBox class, 
except that you can optionally specify a new style (HLS_SCROLL) when you create a 
CHLi stBox object. CHLi StBox can be created in two different ways: 

// two ways to create CHListBox 
CHListBox A; 

CHListBox B(HLS_N0SCROLL); 

If you don’t use the HLS_N0SCR0LL argument, then the listbox will immediately scroll to the 
left end every time the widest item is deleted (as in the LISTHORZ example). Although some¬ 
times inconvenient, it is slightly faster than the other method. 

A listbox will retain the horizontal position if that listbox was created with the 
HLS_N0SCR0LL parameter and if it displays a valid area after every widest item delete. If the 
listbox displays an invalid area, then the listbox will be scrolled just enough so that it points 
to a valid area. 
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programmers have to 
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This article provides 
an MFC class called 
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Understanding CHListBox 

The source code to CHListBox is in hlistbox.h (Listing 1) and 
hlistbox.cpp (Listing 2). The listbox itself handles a significant 
amount of horizontal scroll logic, leaving CHLi StBox with only two 


Listing 1: hlistbox.h — CHListBox declarations 


#1fndef _HLISTBOX_H_ 
#define _HLISTBOX_H_ 

♦include <afxwin.h> 
♦Include <afxext.h> 

♦define CHUNK_SIZE 256 


(/define HLS.SCROLL 0 
l //define HLSJOSCROLL 1 

| //Horz Scroll List Box 
1 class CHListBox : public CLiStBox 

J { 

SortedExtent se; 
int nXStyle; 

int GetTextWidth( LPCSTR 1pszltem ); 
void Reposition(int nMax, int nNewMax); 

; public: 

CHListBox(int anInt-HLS_SCROLL):CListBox(), nXStyle(anInt){} 
j int AddString( LPCSTR 1 pszltem ); 

I int DeleteString( UINT nlndex ); 

int InsertString( int nlndex, LPCSTR 1pszltem ); 

| void ResetContent( void ); 

11 : 

♦endif 

I /* End of File */ 


responsibilities: setting the horizontal extent of the listbox and 
ensuring that the listbox always displays a valid area. 

The horizontal extent is the width in pixels of the widest item in 
the listbox. To avoid calculating the widths of listbox strings more 
than once, I use a helper class called SortedExtent to keep track of 
the widths of the items in the listbox. Each time an item is added or 
deleted, CHListBox uses SortedExtent to keep track of the widest 
string. If an addition or deletion affects the widest string, I change 
the horizontal extent by calling SetHorizontal Extent (), which 
sends the appropriate message to the listbox. 

When the horizontal extent decreases, you must ensure that the 
listbox displays a valid area. Suppose you scroll the listbox to the 
right-hand side of the longest listbox item and then delete that item. 
Assuming that the next largest string is smaller, the horizontal 
extent will be decreased. The problem is, the listbox is currently 
positioned at a horizontal scroll position that becomes invalid when 
you decrease the horizontal extent. In other words, if you call 
SetHori zontal ExtentO, the user will no longer to be able to scroll 
all the way to the left! CHLi StBox prevents this from happening with 
one of two different techniques. The choice of the technique is 
determined by the two new styles HLS_SCROLL (default) and 
HLSJOSCROLL. 

If you used HLS_SCROLL, the code scrolls to the left end of the 
listbox whenever the horizontal extent decreases. Using 
HLS_SCROLL is faster, but sometimes less convenient, than using 
HLSJOSCROLL. This technique is fairly straightforward and the 
LISTHORZ sample uses it. 
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If you used HLS_N0SCR0LL, the code checks whether or not the 
listbox is pointing to a valid area when the horizontal extent 
decreases. If the listbox points to a valid area, the code does not 
scroll at all. If the listbox points to an invalid area, the code scrolls 
just enough to make the listbox point to a valid area. Using 
HLS_N0SCR0LL is slower, but less visually jolting for the user, than 
using HLS_SCROLL. The crux of the problem is finding out if the list- 
box is pointing to an invalid area. With the aid of Figure 1, the fol¬ 
lowing text explains my solution. 

Even though you set the listbox’s horizontal extent to the width 
(in pixels) of the largest string, the actual maximum number of 
pixels that the listbox will scroll equals the horizontal extent 
minus the width of the listbox client area. That’s because the list- 
box lets the user scroll until the last character of the largest string 
becomes visible; it doesn’t let the user scroll the largest string 
completely out of sight. 


-HorizontalExtent, nMax- 

New Horizontal Extent, nNewMax -> 
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Listing 2: hlistbox.cpp — CHListBox definitions 


(/include <afxwin.h> 
i/include <afxext.h> 

(/include "hlistbox.h" 

// ************ begin sorted extent class 
(/include (string.h> 

j //Sorted int container 
class SortedExtent 

! i 

int *pn; 
int nSize; 
int nCount; 


Id mean more 
iftware, Inc. it 
id Macintosh®, 
mbedded and 
ir existing 16- 

and JJ-bit Windows source code to all of your tar¬ 
get platforms. Recompile, relink to our libraries, test 
and that's it! You can now offer native support and 
performance of your Windows applications on 
many more operating systems with very little incre¬ 
mental effort! 
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Listinq 2: hlistbox.cpp — continued 

i CDC *pDC - GetDCO; 

1 public: 

■ CFont *pFont - pDC->SelectObject ( GetFont ()); 

CSize sz - pDC->GetTextExtent(1pszltem, 1strlen(1pszltem) ); 

SortedExtent(){pn - new int[CHUNK SIZE]; 
nSize - CHUNK SIZE; nCount - 0;} 

pDC->GetTextMetrics ( &tm); 

-SortedExtentO {delete []pn; } 

BOOL Addtint anlnt); 

pFont - pDC->SelectObject(pFont); 

ReleaseDC(pDC); 

BOOL RemoveUnt anlnt); 

int GetMax(){return nCount?pn[0]:0;} //If empty 0 is max 

//To avoid clipping of some pixels add a little extra, 
return sz.cx+tm.tmAveCharWidth; 

} 

void Reset(){delete[]pn; pn - new int[CHUNK_SIZE]; 

nSize - CHUNK.SIZE; nCount = 0;} 

//Add a string to list box. 

1 

int CHListBox: : AddString ( LPCSTR 1 pszltem ) 

{ 

//Perform original 

//Adds an extent to the sorted container. 

. BOOL SortedExtent::Add(int anlnt) 

{ 

if ( nCount >- nSize) 

int nRetVal - CListBox::AddString(lpszItem) ; 

//On success manipulate horz extent 

{ 

if(nRetVal >- 0) 

//Container full so grow it. 

{ 

int *p - new int[nSize + CHUNK_SIZE] ; 

int nMax - se.GetMaxO; 

memcpy(p, pn, sizeof(int)*nCount) ; 
delete []pn; 

se.Add ( GetT extWidth (1 pszltem)); 

pn - p; 

nSize +- CHUNK SIZE; 

} 

//Locate the position to insert 

if(se.GetMaxt) > nMax) 

SetHori zontalExtent ( se.GetMax( )); 

} 

return nRetVal ; 

} 

int i, j; 

ford - 0; i < nCount; 1++) 
if(anlnt > pn[i ]) 

//Delete a string from list box. 

break; 

int CHListBox: : DeleteString ( UINT nlndex ) 

//Hove the rest down 

CString str; 

for(j - nCount-1 ; j >- i ; j--) 

GetTexttnlndex, str); 

pn[j+l] - pn[j ]; 

//Insert 

//Perform original 

int nRetVal - CListBox::DeleteString(nlndex); 

pn[i] - anlnt; 

nCount++; 

//On success manipulate horz extent 

If(nRetVal >- 0) 

{ 

int nMax - se.GetMaxO; 

return TRUE; 

] 

se.Removet GetTextWidth(str)); 

//Removes an extent from the sorted container. 

if(se.GetMaxt) < nMax) 

BOOL SortedExtent::Remove(int anlnt) 

{ 

{ 

//locate the position to remove 

SetHori zontal Extent! se.GetMaxO) ; 

Reposition(nMax, se.GetMaxO); 

int i, j; 

} 

} 

ford - 0; i < nCount; i++) 

If(anlnt — pn[i ]) 

return nRetVal ; 

break; 

} 


//Insert a string to list box at specified index. 

return FALSE; 

int CHListBox: : InsertString( int nlndex, LPCSTR 1pszltem ) 

//move the rest up 

//Perform original 

for(j - i ; J < nCount-1; j++) 

int nRetVal - CListBox: : InsertStringtnlndex, 1pszltem) ; 

pn [j] - pn[j+l]; 

nCount-- ; 

//On success manipulate horz extent 
if(nRetVal >- 0) 

{ 

if((nCount + CHUNK SIZE) < nSize) 

{ 

//More than CHUNK SIZE of space unused so shrink it 

int nMax - se.GetMaxO; 

se. Add(GetTextHidth( 1 pszltem) ); 

int *p - new int[nSize-CHUNK SIZE]; 

if ( se.GetMaxt ) > nMax) 

memcpytp, pn, $izeof(int)*nCount); 

SetHori zontal Extent! se.GetMaxO); 

} 

delete [jpn; 

pn - p; 

} 

return nRetVal; 

} 

//Reset contents of list box. 

return TRUE; 

} 

// ************ en( j sorted extent class 

void CHListBox::ResetContent( void ) 

{ 

CListBox::ResetContent();//Perform orignal 

//Return the width of text in pixels. 

//Manipulate the scroll extent. 

int CHListBox::GetTextWidth( LPCSTR 1pszItem) 

se.Resett); 

{ 

SetHorizontalExtent(O); 

TEXTMETRIC tm; 

} 
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Listing 2: hlistbox.cpp — continued 


//Reposition the list box 

void CHListBox::Reposition(int nMax, int nNewMax) 

( 

iftnXStyle - HLS NOSCROLL) 

{ 

int nMinPos, nMaxPos, nRange, nPos; //Scroll Bar info 
int nLBWidth; //List Box client width 
int nPix; //No of pixels scrolled 

CRect rect; //Client rect of listbox 

GetScrollRange(SB_HORZ, &nMinPos, SnMaxPos): 

//If nMaxPos is 0 then no scroll bar so no need to check, 
if(nMaxPos) 

{ 

nRange - nMaxPos - nMinPos; 

nPos - GetScrollPos(SB_H0RZ) - nMinPos; 

GetClientRect(irect); 
nLBWidth - rect.WidthC): 

nPix - (nMax - nLBWidth) * nPos / nRange; 

iftnNewMax < (nPix + nLBWidth)) //Invalid area? 

{ 

SetHorizontalExtent(nNewMax); 

SendMessage(WM_HSCROLL, SB_RIGHT, 

MAKELONGCO, this->m_hWnd)); 

} 

) 

) 

else 

SendMessage(WM_HSCROLL, SB_LEFT, 

MAKELONGtO. this->m_hWnd)); 


Let Horizontal Extent be the width of the widest string, 
LBWidth be the width of the listbox, and ScrollBarPos and 
Sc rol 1 Bar Range be the current position and range of the scrollbar, 
respectively. The following formula produces the number of pixels 
currently scrolled to the right: 

PixelsScrolled = 

(HorizontalExtent - LBWidth) 

* Scrol1BarPos / ScrollBarRange 

In Figure 1, if the “BBB...” string is deleted, and the point of interest 
(the right side of the listbox) is beyond the right end of line “DDD...”, 
then the listbox is displaying an invalid area. In other words, if 

(PixelsScrolled + LBWidth) > NewHorzExt 


is TRUE, then the listbox is displaying an invalid area. 


Summary 

CHLi StBox does nothing special for the redraw flag on/off status 
because the default listbox behavior handles it. If you use VC++, 
and if you decide to use CHLi StBox frequently, you can inform 
ClassWizard about this by entering the three lines in Figure 2 in the 
“[Generallnfo]” section of your project, cl w file. Then, CHLi stBox 
will be available to you when you use ClassWizard to add control 
variables mapping to a listbox. □ 



Download the code from www.wdj.com/source.htm. 
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A VxD for Custom SYSMON 
Statistics 

Windows 95 ships with a utility called SYSMON that can display various system statis¬ 
tics (see Figure 1). If the SYSMON interface were extendible, you might find a variety of 
uses for it in your applications — for example, displaying the rate of outgoing RPC requests 
or the hit rate of some internal caching algorithm. Such information could be very useful for 
debugging or for tuning algorithms for optimal performance. It turns out that the underlying 
mechanism SYSMON uses is extendible — but only at the VxD level. This article describes 
a wrapper, consisting of a DLL and a VxD, that allows any application to create custom sta¬ 
tistics that users can then graphically display and monitor using SYSMON. For the price of 
a few function calls, you get a ready-made graphical user interface for non-intrusively dis¬ 
playing custom program statistics. 



What is SYSMON? 


Windows 95 does not, by default, install SYSMON (sysmon. exe). Check your Windows 95 
“Programs” menu in the “System Tools” menu under “Accessories.” If you don’t see “System 
Monitor” listed there along with other system utilities such as “Disk Defragmenter” and 
“Resource Meter,” then you will have to install it from your original Windows 95 CD-ROM. 

As you can see in Figure 1, SYSMON acts as a “watch window” into Windows internals, 
allowing users to monitor over time, and display in the form of charts, some vital dynamic 
parameters of the operating system. The performance data is divided into categories such as 
“Kernel,” “Memory Manager,” “File System,” etc. These categories contain the actual perfor¬ 
mance items (e.g., “Number of Threads” and “Processor Usage” for the “Kernel” category). 
The user can select which items to watch using the straightforward user interface. One great 
advantage of using SYSMON is that it imposes essentially zero overhead on the program 
being monitored. 

How SYSMON Works 


“This article 
describes a wrapper, 
consisting of a DLL 
and a VxD, that 
allows any application 
to create custom 
statistics that users 
can then graphically 
display and monitor 
using SYSMON.” 


Matt Pietrek explained the internal mechanics of Windows 95 performance monitoring in the 
September 1995 issue of Microsoft Systems Journal. Basically, SYSMON gets its performance 
data from DWORD entries in the registry; you can see a sample of the data by using regedi t. exe, 
as shown in Figure 2. SYSMON even gets the names and descriptions for all the available statis¬ 
tics from the registry; that data is not “dynamic,” so it resides elsewhere in the registry under 


HKEY_LOCAL_MACHINE 
\System 

\CurrentControlSet 

\control 

\PerfStats 

\Enum 


Although the data that SYSMON displays is available via a very high-level means (all 
you have to do is read the registry), the data gets placed in the registry at a very low level. 
Windows 95’s performance monitoring services are provided by a VxD called perf .vxd. 
You won’t find this file in your Windows system directory; perf .vxd is a service built into 
vmm32. vxd. perf. vxd exposes ring 0 services that allow other VxDs to register and maintain 
their performance information. 

The DDK documentation on PERF services is scarce. The basic idea is that each ring 0 
subsystem (VxD) that wants to publish statistics will register with perf .vxd by creating a 
so-called statistics server. A statistics server is merely a descriptor with an ASCII name, 
which you would see in SYSMON’s “Select Category” listbox. Then the subsystem registers 
its statistics items (called statistics nodes) with the created statistics server. Each statistics 
node is associated with a DWORD memory location that contains the current value of the sta¬ 
tistic. The VxD publishing the statistics updates this DWORD as it sees fit, and perf .vxd peri¬ 
odically polls the value; since those events occur asynchronously, each DWORD containing a 
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statistic should be located in page-locked memory in the shared sys¬ 
tem area where all Windows 95 VxDs reside (linear addresses 
OxCOOOOOOO and up). 

At the VxD level, perf .vxd provides an interface that lets other 
VxDs dynamically define new statistics, perf. vxd places the descrip¬ 
tive information in the registry, periodically polls the available statis¬ 
tics (each statistic is just a DWORD location in memory), and makes the 
results available in the dynamic portion of the Windows 95 registry. 



Figure 1: SYSMON displaying some Win95 system 
statistics 
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That’s great if you’re writing a VxD, but applications could also ben¬ 
efit from such a feature. That’s why I set out to write a wrapper VxD 
that lets applications take advantage of the features of perf .vxd. 

Inside statprox.vxd 

I created a proxy VxD that lets ring 3 applications access the ring 
0 features of perf .vxd. An application could call my proxy VxD 
directly, but I created a DLL (appstats.dll) that handles all the 
details of loading and calling my VxD; the DLL exposes a very sim¬ 
ple functional interface that any application can use to publish sta¬ 
tistics. statprox.vxd is written in C++ using the VtoolsD frame¬ 
work. Describing the VtoolsD framework and Vireo’s fine class 
libraries is beyond the scope of this article, so I’ll address just the 
general design of the VxD. The VxD’s source code is in Statprox. h 
(Listing 1), statprox.cpp (Listing 2), and cl asses. cpp (Listing 3). 

statprox.vxd is a dynamically loadable VxD that exposes a 
Win32 DeviceloControl () interface and translates I/O control 
codes into requests to Windows 95’s perf .vxd. The control codes 



llOelaultl 

)KERNEL\CPUU8age 

|KERNEL\Threads 

|KERNEL\VMs 

|MSNServer\BBytes 

|MSNSerw\Buffers 

|MSNServer\Bytas 

|MSNServertNBs 

|MSNS@rverMhreads 

MSNServerNThroughput 

|MSNServ@r\Writes 

|Nw1ink\IPX_Packetsln 

|Nwtlnk\IPX_PacketsLost 

|Nwtink\IPX_Sends 

|Nwlink\IPX_Sock3tsOpen 

|Nw«nk\RIT_Entrtes 

|Nwlink\SITEntries 


$ My Computer 
S £9 HKEY_CLASSES_ROOT 

* HKEY_CURRENT_USER 

% Hi hkey_local_machine 

* HKEYJJSERS 

'+* @9 HKEY_CURRENT_CONFIG 
e £3 HKEY_D YN_DATA 
s+i Conflg Manager 
B Ll PerfStats 
StartSrv 
£*JStartStat 

StopSrv 
£3 StopStat 


(value not set) 
84 00 00 00 
25 00 00 00 
02 00 00 00 
e7 7c 00 00 
00 00 00 00 
00 00 00 00 
Oa 00 00 00 

04 00 00 00 
00 00 00 00 
00 00 00 00 
2e 00 00 00 
00 00 00 00 
2e 00 00 00 
08 00 00 00 
00 00 00 00 
00 00 00 00 


Figure 2: Registry locations SYSMON accesses 


Listing 1; statprox.h — Header file for statprox. vxd 


| // STATPROX.h - include file for VxD STATPROX 

j(/include <vtoolscp.h> 

(/define OEVICE_CLASS StatproxDevice 

| (/define STATPROX_DeviceID UNDEFINED_DEVICE_ID 

/(/define STATPROX_Init_Order UNDEFINEDJNIT.ORDER 
z (/define STATPROXJlajor 1 

(/define STATPROX_Minor 0 

(j (/include <statdioc.h> 

I (/include "classes.h" 

/ class StatproxDevice : public VDevice 
| 1 

j protected: 

CPerfHeap* 
j int 

CStatServer* 

STATHANDLE 

void 


public: 

virtual BOOL OnSysDynamicDevicelnitO; 

virtual BOOL OnSysDynamicDeviceExitO; 

virtual BOOL OnDevicelnit(VMHANDLE hSysVM, PCHAR pszCmdTail); 

virtual DWORD 0nW32DeviceIoControl(PIOCTLPARAMS pDIOCParams): 

j 1: 

c /* End of File */ 


m_pPerfHeap: 
mJJsage; 

GetServerNodetconst char* szServer); 
AddStattCStatServer* pServer, const char* szName, \ 
const char* szDesc, BOOL bValueNotRate, int* index); 
RemoveStat(CStatServer* pServer, const STATHANDLE \ 
hStat, const int index); 
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Listing 2: statprox.cpp — Main module for statprox.vxd 


j // STATPROX.cpp - main module for VxD STATPROX 

I 11 

1 II 11/20/96 VV Original 
| // 

// This VxD acts as a RingO proxy for Ring3 stats making them 
// visible at the Win-95 SYSMON application. The VxD serves as 
i; // a gateway between a Win32 app and Microsoft's PERF.VXD. 

| 11 

//define DEVICEJtAIN 
//include "statprox.h" 
l Declare_Virtual_Device(STATPROX) 
j //undef DEVICE_MAIN 

///include <Vs vctab. h> 

//include "cl asses, h" 

| BOOL StatproxDevice::OnSysDynamicDeviceInit() 

{ 

if (::PERF_Get_Version() <- 0) 

return FALSE; // refuse to load unless PERF is avail 
m_pPerfHeap - NULL; m_Usage - 0; 

! return TRUE; 

I > 

; BOOL StatproxDevice::OnSysDynamicDeviceExit() 

j { 

if <m_Usage—0) { 
if (m_pPerfHeap) 

delete m_pPerfHeap; 
return TRUE; 



BOOL StatproxDevice::OnDeviceInit(VMHANDLE, PCHAR) 

1 { 

| // called when loaded statically (system.ini/[386Enh]) 

I return OnSysDynamicDevicelnitO: 

I ) 


DWORD StatproxDevice::0nW32DeviceIoControl 

(PIOCTLPARAMS pDIOCParams) 

{ 

// define names for convenience: 


//define Func 
//define pStructl 
//define p$truct2 
//define pdwResult 
//define pProcess 


pDIOCParams->dioc_I0CtlCode 

pDIOCParams->dioc_InBuf 

pDIOCParams->dioc_OutBuf 

pDIOCParams->dioc_bytesret 

pDIOCParams->dioc_ppdb 


switch (Func) { 

// OS-provided control codes: 
case DI0C_0PEN: 

// CreateFileO was called: create the list on 1st usage 
if (m_Usage+H——0) 

CStatServer::CreateList(); 
break; // ok 

case DIOCJLOSEHANDLE: 

// CloseHandleO was called: destroy if it was the last 
if (--m_Usage~0) { 

CStatServer::DestroyList(); // last gone, destroy everything 
if (m_pPerfHeap) delete m_pPerfHeap; m_pPerfHeap-NULL; 

} 

break; 

case STATDIOCJNIT: 

// pass a shared area to be used for all monitorees 
// pStructl -- area 
if (mjPerfHeap) delete m_pPerfHeap; 
m_pPerfHeap - new CPerfHeaptPDW0RD(pStructl)); 
break; 

case STATDIOC.DEINIT: 

// inform that the shared are is about to disappear 
if (m_pPerfHeap) 

t delete m_pPerfHeap; m_pPerfHeap-NULL; } 
break; 

case STATDIOC_REGISTER_STAT: 

// register a stat: 

// pStructl -- STATDI0C_req_t; 

// pStruct2 -- STATDI0C_resp_t; 
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are defined in statdioc.h (Listing 4). The very first I/O code 
statprox.vxd receives from appstats.dll is STATDI0C_I NIT. 
appstats.dll uses this code to pass the address of a shared memory 
page, statprox.vxd page-locks this memory (one page) and then uses 
it as a heap, from which it allocates to-be-monitored DWORDs. Class 
CPerf Heap implements a trivial heap manager to handle the job. 

Statprox.vxd maintains a list of “statistics servers” (in 
perf.vxd’s terminology) with each node representing an unique 
category name. Each statistics item is attached to a particular statis¬ 


tics server. This arrangement is dictated by the perf. vxd API. 

To create a new statistic, appstats.dll sends a 
STATD 1 0C_REG I STER_ST AT I/O code to statprox.vxd. If a new cat¬ 
egory is being created, Statprox.vxd creates a new server node (of 
type CStatServer). Then the VxD allocates a DWORD from the 
CPerf Heap heap and calls the PER F_S e r v e r_Ad d_S t a t () service of 
perf .vxd, which actually creates the statistics item. To remove a 
previously created statistic, appstats.dll sends a 
STATDIOC_UNREGISTER_STAT I/O code to statprox.vxd, which 


Listing 2: statprox.cpp — continued 


PSTATDIOC_resp_t(pStruct2)->index - -1; // assume failure 
{ CStatServer* pServer - 

GetServerNodeC PSTATDIOC_req_tCpStructl)->pszSubsystem); 
if (pServer) { 

PSTATDI0C_resp_t(pStruct2)-XhServerCookie - 
DW0RD(pServer); 

PSTATDI0C_resp_t(pStruct2)-XhStatCookle - 
DWORD(AddStat( 
pServer. 

PSTATDIOC_req_t(pStructl)->pszName, 
PSTATDIOC_req_t(pStructl)->pszDescription, 
PSTATDIOC_req_t(pStructl)->bValueNotRate, 
&PSTATDI0C_resp_t(pStruct2)->index)); 

} 

} 

break; 

case STATDI0C_UN REG ISTER_STAT: 

// unregister a stat; 

// pStructl -- $TATDIOC_resp_t; 

// pdwResult -- BOOL if any servers left 
*pdwResult - FALSE; 

{ CStatServer* pServer - (CStatServer*) 

(PSTATDIOC_resp_t(pStructl)->hServerCookie); 
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e-mail: crypkey @ kenonic.com 


if (pServer M pServer-MsGoodO) 

RemoveStattpServer, 

PSTATDIOC_resp_t(pStructl)->hStatCookie, 
PSTATDIOC_resp_t(pStructl)->index 
); 

else 

break; // bad descriptor? 

} 

// now, indicate if any servers left; 
if (!CStatServer:;First()) *pdwRe$ult - TRUE; 
break; 
default: 

return 1; // err 

} /* switch */ 
return 0; 

} 

CStatServer* StatproxDevice::GetServerNode(const char* szServer) 
{ 

// Find existing or create a new one 
CStatServer *pnode-CStatServer::First(): 
while (pnode) { 

if (strcmp(pnode->Name(), szServer)—0) 
break; 
else 

pnode - CStatServer::Next(pnode); 

} 

if (!pnode) { 

pnode - new CStatServer(szServer); 
pnode->Append(); 

} 

return pnode; 


STATHANDLE StatproxDevice::AddStat(CStatServer* pServer, 
const char* szName, 
const char* szDescription, 

BOOL bValueNotRate, int* pindex) 

{ 

int ix - m_pPerfHeap->Allocate(); // alloc a dword 
if (ix>-0) { 

STATHANDLE hStat - 
pServer->AddStat( 
szName, 

szDescription, 
m_pPerfHeap->GetAddr(ix), 
bValueNotRate); 
if (hStat) { // OK! 

*pindex - ix: 
return hStat; 

} 

) 

return NULL; 


void StatproxDevice::RemoveStat(CStatServer* pServer, 

const STATHANDLE hStat, const int index) 

1 

m_pPerfHeap->Free(index); // free the dword 

pServer->RemoveStat(hStat); 

// now, check if this server deserves to live any longer 
if UpServer-MsReferencedO) { 

pServer->Remove(); // out of the list 

delete pServer; // kill 

} 


// end of file 
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Listing 3: classes.cpp — Support classes for 
statprox.vxd 


// Classes.cpp -- class implementations for STATPROX 

//include "cl asses, h" 

//include <Vsvctab. h> 

// common prefix for app's statistics: 

char CStatServer::sm_szNamePreffix[MAXNAMELEN] - "App::"; 

VList* CStatServer::sm_pList-NULL: 

// Constructor: registers a stats "server" 

CStatServer::CStatServer(const char *szName) : 
cm_Signature(OxAAAABBBB), m_RefCount(0) 

{ 

m_Signature - cm_Signature; 
char szShowName[128]; 

strcat(strcpy(szShowName, sm_szNamePreffix), 

strncpy(m_szName, szName, sizeof(m_szName)-1)): 

PERF_SERVER_0 PerfMonServer; 

PerfMonServer.psrvO_Level - OL; 

PerfMonServer.psrvO_Flags - PSTF_RATE; //0? 

PerfMonServer.psrvO_pszServerName - szShowName; // @ SYSMON 

PerfMonServer.psrvO_pszServerNodeName - szShowName; 
PerfMonServer.psrvO_pControlFunc - NULL; 

m_hPerfMonServer - ::PERF_Server_Register (^PerfMonServer): 

) 

// Destructor: deregister a stats server 
CStatServer::~CStatServer() 

{ 

// NOTE: PERF.VxD doesn't remove stats even if their server 
// ...— has gone (weird) -> BAD -> the DLL should keep 
// track and release malicious stats, 
if (m_hPerfMonServer) 

::PERF Server_Deregister (m_hPerfMonServer); 

) 

// Creates the List: should be called first & once: 
void CStatServer::CreateList() 

{ 

sm_pList - new VList(sizeof(CStatServer)); 

} 

// Destroys the list: should be called last: 
void CStatServer::DestroyList() 

{ 

// remove each server and destroy its node list 
CStatServer* snode; 

while ((snode—CStatServer::First())!—NULL) { 
snode->Remove(); 
delete snode; 

); 

delete sm_pL1st; 
sm_pList-NULL: 


// Adding/Removing stats 

STATHANDLE CStatServer::AddStat(const char* szName, 

const char* szDescription, DWORD* where, BOOL bValueNotRate) 

{ 

PERF_STATJ Stat; 

STATHANDLE hStat-NULL: 

Stat.pstO.Flags - (bValueNotRate) ? PSTF_COUNT : PSTF_RATE; 
Stat.pstO_Level - OL; 

Stat.pstO_pszStatNodeName - (char*)szName; 

Stat.pstO_reserved - NULL; 

Stat.pstO_ScaleFactor - OL; 

Stat.pstO_pszStatName - (char*)szName; 

Stat.pstO_pszStatDescription - (char*)szDescription; 

Stat.pstO_pStatFunc - (void *)where; 

if (m_hPerfMonServer) { 

hStat - ::PERF_Server_Add_Stat (m_hPerfMonServer, SStat); 
if (hStat) 

{m_RefCount++; ) 

) 
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undoes the creation operation in the opposite order: it calls 
PERF_Server_Remove_Stat( ), frees the corresponding DWORD from 
the heap, and — if this is the last item for the given category — 
destroys the statistics server. 

statprox.vxd is involved only in creating or removing statis¬ 
tics, not in setting the values of those statistics, appstats .dll can 
handle altering the actual DWORDs that represent the statistics direct¬ 
ly from ring 3. Thus, the proxy VxD does not add any overhead to 
the recording of statistics. 

Inside appstats.dll 

The source code for appstats.dll resides in two files: 
appstats.h and appstats.c. appstats.h (Listing 5) contains defini¬ 
tions for the API that the DLL exports; this is the header file you will 
include in your application, appstats.C (Listing 6) contains the 
source for the DLL. The DLL source code also uses Statdioc.h 
(Listing 4), which defines the interface between the DLL and the VxD. 

At startup, the DLL calls Initialized (see appstats.c), 
which establishes the interface with statprox.vxd. First, 
Initialized opens the “STATPROX” device by calling 
CreateFi 1 e( ). Note that statprox.vxd is designed to be loaded 
dynamically, but it can also be loaded statically: just add the follow¬ 
ing line to the “[386Enh]” section of system-ini. 

device-statprox.vxd 


Alternatively, you could place statprox.vxd and appstats.dll 
into your Windows system directory, without having to bother with 
system .ini. The code accounts for both cases by trying to open the 
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device either by its module name (statically loaded or preloaded) or 
by its filename (dynamically loaded). Second, Initialized cre¬ 
ates a shared memory area in which to store DWORDs for statistics. 
This area must be accessible from both ring 3 and ring 0. To achieve 
this, I used a memory-mapped file. CreateFi 1 eMappi ng () creates a 
named memory mapping in the Windows 95 shared address space 
(linear addresses 0x8000000 to OxCOOOOOO). The memory mapping 
must be named (I used the name “APPSTATSJHEAP”) so that the 
same memory area is used across all processes using appstats .dll. 
The size of the area is 4,096 bytes (one page), which is enough to 
accommodate up to 1,024 statistics system-wide. 

After creating the memory mapping object, I map it into the 
process’s address space using MapViewOfFiled, which returns the 
actual linear address. This address is then passed to the VxD (using the 
DRIVER_REQUEST macro) provided it was the very first mapping for the 
named object “APPSTATS_HEAP”. How do you know whether or not 
it was the first mapping? If you call GetLastError( ) immediately 
after calling CreateFi 1 eMappi ng (), GetLastErrorO will return 
ERROR_ALREADY_EX I STS if the mapping had been previously created 
by another process. 

Finally, Initialized constructs the default category name for 
the current process. Whenever an application calls appstats .dll to 


Listing 3: classes.cpp — continued 


return hStat; 

1 

void CStatServer::RemoveStat(STATHANDLE hStat) 

{ 

if (hStat U mJiPerfMonServer) { 

::PERF_Server_Remove_Stat(hStat); 
m_RefCount--; 

1 

1 

// Stats "heap" implementation 
CPerfHeap::CPerfHeap(DWORD* pArea, DWORD size) : 
m_pArea(pArea), m_size(size) 

{ 

// lock the "heap" and clean the bitmap 
_LinPageLock(DW0RD(m_pArea)»12, 

m_size/4096 + ((DWORD(m_pArea)&0x0FFF)?2:1), 

PAGEMAPGLOBAL); 

memset(m_Bitmap, 0, sizeof(m_Bitmap)); 

1 

CPerfHeap::~CPerfHeap() 

1 

_LinPageUnLock(DW0RD(m_pArea)»12, 

m_size/4096 + ((DW0RD(m_pArea)&OxOFFF)?2:1), PAGEMAPGLOBAL); 

} 

// Get a DWORD in the area and mark a bit in m_Bitmap as "used": 
int CPerfHeap::A1 locateO 

I int i.j; 

for (i-0; i<MAXITEMS; 1++) 

if (m_Bitmap[i] !- DWORD(-l)) 
for (j-0; j<31; j++) 

if ((m_Bitmap[i] & (l«j))—0) 

{ m_Bitmapti] |- l«j; 
return i*32+j; 

1 

return -1: // too many stats? 

1 

// Frees the dword at index: 
void CPerfHeap::Freednt index) 

( 

if (index>-0 M index<MAXITEMS) 

m_Bitmap[index/32] &- ~(l«indexSS32); 

1 

II end of file 
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create a new statistic, it can specify both the statistic name and 
the category name. If the category name is left NULL, 
appstats . dl 1 will use the name of the calling process’s .exe as a 
default value. Initialized constructs this default value using 
GetModuleFileNameO and GetFileTitleO. 

After initialization, appstats .dll is ready to create statistics on 
behalf of the calling application. When the application calls 
StatCreatet), it allocates the descriptor HSTAT_t to be associated 
with the new statistic. The descriptor’s pointer becomes a statistics 


handle — a magic cookie returned to the caller. All the descriptors 
are linked into a list pointed to by the static variable S_pStatsLi St. 
The purpose of this list is safety: when the application crashes or 
fails to destroy its statistics for whatever reason, appstats .dll uses 
the list to perform graceful cleanup. 

If the descriptor allocation succeeded, StatCreatet ) passes the 
request to the VxD which, if it can successfully allocate the new 
statistic, returns the index into the shared memory area of the new 
DWORD associated with that statistic. StatCreatet ) then constructs a 


Listing 4: statdioc.h — Device control codes for 
statprox.vxd 


LUMSt. Uldi 

BOOL 


bValueNotRate; 


1 ///////////////////////////////////////////////////////////// 



// 


typedef struct 1 


1 // StatDioc.h - Definitions for DeviceloControl API to 

int index; 


// of the StatPrxy.VXD 


DWORD hStatCookle; 


II 


DWORD hServerCookle; 


II 12/16/96 VV Original 


} STATDIOC_resp_t, *PSTATDIOC_resp_ 

t; 

// 


//pragma packO 


I //////////////////////////////////////////////////////////// 



#ifndef STATD10C H 


// how we talk to the vxd 


♦define _STATDIOC_H 


//define DRIVER_REQUEST(h, func, struct 



DeviceloControl( 

\ 

// OevIoCtrl interface to WHSPERFS.VXD 


h, 

\ 

♦define STATDIOC INIT 1 // 

set a shared memory 

func, 

\ 

(/define STATDIOC DEINIT 2 // 

undo init 

struct p, 

\ 

//define STATDIOC REGISTER STAT 4 // 

register a stat 

sizeofCSTATDIOC_req_t), 

\ 

//define STATDIOC_UNREGISTER_STAT 5 // 

unregister a stat 

ret_struct_p, 

\ 



sizeof(STATDIOC_resp_t). 

\ 

: //pragma pack(4) 


ret p, 

\ 

I typedef struct { 

// used to register a stat 

NULL 

\ 

j const char* pszName; 


) 


const char* pszDescriptlon; 




1 


//endif // _STATDIOC_H 



// driver retutns this: 
// index in the area,>-0 
// stats handle 
// server handle 
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pointer to the new DWORD and stores that in the pMoni toree field of 
the descriptor for this statistic. 

It’s unlikely but possible that perf .vxd will fail and the VxD 
will not be able to create the new statistic. In this case, as well as in 
the case of the descriptor allocation failure, appstats.dll resorts to 
a “bogus” mode, returning a HSTAT handle which can be passed to 
other functions — but that won’t actually do anything. 

The functions supplied by the DLL for manipulating individual 
statistics (stat Inc()/statDec(), statSet()/statGet( )) are trivial: 
the passed handle is cast to a descriptor’s pointer, and then the 
pMoni toree pointer is used to access the associated DWORD. 

Finally, statDestroy () undoes what statCreate( ) has done: it 
removes the statistics descriptor from the list, passes the request to 
destroy the item to Statprox. vxd, and frees the descriptor. 

The Statistics API 

To create custom statistics in your own application, simply 
include appstats.h (Listing 5) in your source code. Table 1 
describes the five main functions of the API. 

The application creates a statistics item using statCreateO. This 
function returns a handle of type HSTAT, which is then used in all con¬ 
secutive references to this particular statistics item. Conceptually, a 
performance statistics item is a DWORD; this limitation is dictated by the 
low-level implementation of the performance monitoring services in 
Windows 95. After calling statCreate( ) to create a new statistic, the 
application can arbitrarily update it using statSetO, statlncO, or 
statDec(),or retrieve the current value by calling S t a t G e t (). The sta¬ 
tistics updates will be displayed on SYSMON’s charts provided this 
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item had been chosen for monitoring via SYSMON’s user interface. 
When the application is about to exit, it should destroy all the created 
statistics by calling statDestroy () for each of them. However, if the 
application fails to do so (due to a bug or crash), appstats.dl 1 will 
destroy them automatically. 

The only complicated function in the API is StatCreate( ). The 
first parameter (szName) specifies the ASCII name of your statistic; 
it is the name you’ll see on the SYSMON chart when you select that 
statistic for monitoring. The second parameter (stType) specifies 
how you would like SYSMON to render your statistics: by value or 
by rate of change. M0NIT0R_VALUE makes SYSMON render the ordi¬ 
nal value of the statistics item, while M0NIT0R_RATE does “differen¬ 
tiation” by displaying the item’s rate of change per second. The lat¬ 
ter is especially beneficial when you want to monitor the rate rather 
than the counter of events of some sort. For instance, if your appli¬ 
cation wants to monitor packets-per-second it receives from the net¬ 
work, it need only call Sta 11 nc (hSt a t , 1) whenever it gets a new 
packet. No timestamps, no wasteful calculations; SYSMON takes 
care of translating the counter into the rate. 

The third parameter (szDescription) provides an ASCII 
description for the item, which will pop up when the user clicks on 
the “Explain” button in SYSMON’s “Add New Item” dialog. The 
fourth parameter (SzCategory) specifies the name of the category 


Listing 5: appstats.h — Interface definitions for 
appstats.dll. 


| ///////////////////////////////////////////////////////////// 
i u 

1 // Appstats.h - User's API to SYSMON 
1 // 

I // 12/16/96 VV Original 

I 11 

J //////////////////////////////////////////////////////////// 

? #1fndef _APPSTAT$_H 
(/define .APPSTATS.H 

(/if !defined(_APPSTATS_IMPLEMENTATION_) 

(/define APPSTATS.API _dec!spec(dlTimport) 

(/else 

(/define APPSTATS.API _declspec(dl 1 export) 

| (/endif 

1 typedef DWORD HSTAT; 
j typedef enum { 

S MONITOR.VALUE, 

1 MONITOR.RATE 

j } statsmonitor.t; 

(/define MAX.STATS.NAME 50 // max length of stat item's name 

| (/ifdef _cpl uspl us 

1 extern "C" ! 

(/endif 

I APPSTATS.API HSTAT _stdcall statCreateCconst char* szName, 

statsmonitor.t stType, 
const char* szDescription, 
const char* szCategory); 

APPSTATS.API BOOL_stdcal 1 statDestroytconst HSTAT hStat); 

APPSTATS.API DWORD stdcall statGet(const HSTAT hStat); 

APPSTATS.API DWORD stdcall statSet!const HSTAT hStat, 

const DWORD dwVal) 

APPSTATS.API DWORD _stdcall statlncfconst HSTAT hStat, 

const DWORD dwVal) 

APPSTATS.API DWORD _stdcal 1 statDecfconst HSTAT hStat, 

const DWORD dwVal) 

I APPSTATS.API BOOL_stdcalT statlslnstalled(void); 

| (/ifdef _cpl uspl us 

I } 

1 (/endif /*_cpl uspl us */ 

(/endif //.APPSTATS.H 


// statistics handle 
// statistics monitoring mode; 
// by value 
// by rate of change 
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Listing 6: appstats.c — Source code for the wrapper 
DLL 


///////////////////////////////////////////////////////////// 

// 

// AppStats.c - Main module of APPSTATS.DLL: implements 
// an API to SYSMON for Win32 applications. 

// 

// 12/16/96 VV Original 
// 

//////////////////////////////////////////////////////////// 

//define STRICT 

//include <windows.h> 

//include <mal 1 oc. h> 

//define _APPSTATS_IMPLEMENTATION_ 

//include "AppStats.h" 

//include "StatDioc.h” 

// Internal Statistics item descriptor: 
typedef struct HSTAT_Tag_t { 

struct HSTAT_Tag_t* pNext; // for linked list 
PDWORD pMonitoree; // ptr to the monitored dword 

STATDI0C_resp_t idStat; // stats identification 
} HSTAT_t, *PHSTAT_t; 

/////////////////////////////////////////////////////// 

// Internal implementation 

/////////////////////////////////////////////////////// 

// Static data: 

static char s_$zDevice[] - "STATPROX”: // proxy vxd name 

static HANDLE s hProxyDev - INVALID HANDLEJALUE; // vxd's handle 
static HANDLE sJMappedFile - INVALID_HANDLE_VALUE; // memmap file 

static PDWORD s_pArea - NULL; // shared area (stats "heap") 

static PHSTAT_t s_pStatsList—NULL; // active statistics list 
static HSTAT_t s_Dummy-{0, (PDWORD)&s_Dumrny.idStat); // a dummy 
static char s_szDefaultCategory[MAX_STATS_NAME]—"?”; 

////////////////////////////////////////////////////// 

// Initialized: Attach to the driver and create 

// —- shared stats "heap" 

void Initialize(void) 

{ 

char szDevPath[2][MAX_PATH]; 
i nt i; 

BOOL bPassMapToDev; 

// Try to open the device: either as a pre-loaded or 
// or a dynamic one: 

wsprintf(szDevPath[0], "WW.WXs", s_szDevice); 
wsprintf(szDevPath[l], "\\W.\Us.VXD", s_szDevice); 

for (i—0; i<2; i++) 

if ((s_hProxyDev - CreateFi1e((LPCSTR)szDevPath[i], 
GENERIC_READ | GENERICJRITE, 

FILE_SHARE_READ | FILE_SHARE_WRITE, 

NULL, OPEN_ALWAYS, FILE_FLAG_DELETE_0N_CL0SE, 0)) 
l-INVALIDJANDLEJALUE) break; 
if (sJProxyDev—INVALID_HANDLE_VALUE) 
return; 

// The device is available, create named memory-mapped "file" - 
// shared area between the VxD and the app. 
s_hMappedFile - CreateFiTeMapping((HANDLE)-1. 

NULL, PAGEJEADWRITE, 0, 4096, "APPSTATSJEAP"); 
if (s_hMappedFi 1 e—NULL) { // failed, return 

CloseHandle(s_hProxyDev); 
s_hMappedFile-s_hProxyDev-INVALID_HANDLE_VALUE; 
return; 

} 

// Ok, now mark if it was the first file with this name; 

// we might use this fact a few lines below 
bPassMapToDev - GetLastErrorC) !- ERROR_ALREADY_EXI STS; 

// map the area into to the current process's space 
s_pArea - (PDWORD) MapViewOfFi1e(s_hMappedFi1e, 

FILE_MAP_ALL_ACCESS, 0,0,0); 

// pass the "heap" area to the device on the very creation only: 
if (bPassMapToDev) 

DRIVER_REQUEST(s_hProxyDev. STATDIOCJNIT, 
s_pArea, $_pArea, s_pArea); 


// Retrieve the process file name to use as a default 
// "Category" on statCreated: 

GetModuleFileName(NULL, szDevPathCO], MAX.PATH); 
GetFileTitle(szDevPath[0], 

s_szDefaultCategory, sizeof(s_szDefaultCategory)); 


////////////////////////////////////////////////////// 

// Deinitialized: Detach from the driver and destroy 

// -— the stats "heap" 

void Deinitialize(void) 

{ 

UnmapViewOfFi1e(s_pArea); s_pArea-NULL; 

CloseHandle(s_hMappedFi1e): 

CloseHandle(s_hProxyDev); 
s_hMappedFile-s_hProxyDev-INVALID_HANDLE_VALUE; 

} 

///////////////////////////////////////////////////// 

// DUMainO: Standard Win32 DLL entry/exit point 
// —_ 

//if defined(_BORLANDC_) 

// pragma argsused 
i/endif 

BOOL WINAPI DUMainfHINSTANCE hinstDll, DWORD fdwReason, LPV0ID p) 
{ 

switch (fdwReason) { 

case DLL_PR0CESS_ATTACH: 

// Initialize resources: 

Initialized; 

break; 

case DLL_PR0CESS_DETACH: 

// Destroy all existing statistics, release resources: 
while (s_pStatsList) 

statDestroy((HSTAT)s_pStatsList); 

Deinitialized; 

break; 

} 

return TRUE; 


// User API implementation 

/////////////////////////////////////////////////////////// 

// statCreated: Create a SYSMON statistics item 

// - 

// Parameters: 

// szName: Statistics Name 

// stType: Monitoring mode: value or change rate 

// szDescription: Optional description string (or NULL) 

// szCategory: Optional Category string, (or NULL) 

// Returns: 

// Stats Handle. NOTE: it could be a dummy one, never NULL. 

APPSTATS_API HSTAT _stdcall statCreate(const char* szName, 

statsmonitor_t stType, 
const char* szDescri pti on. 
const char* szCategory) 

{ 

STATDI0C_req_t req; 

PHSTAT_t pStat - malloc(sizeof(HSTAT_t)); 

req.pszName - szName ? szName : "?"; 

req.pszDescription - szDescription ? szDescription : 
req.pszSubsystem - szCategory ? szCategory : s_szDefaultCategory; 
req.bValueNotRate - (stType -- M0NIT0RJALUE); 

// if descriptor allocation succeeded, register the stat with 
// the driver, and insert the descriptor into the list. If the 
// VxD is not present use an internal area to store the stat: 

if (pStat) { 

if (statlslnstalledd) { 

DRIVER_REQUEST(s_hProxyDev, 

STATDI0C_REGISTER_STAT, &req, 

&pStat->idStat, (LPDW0RD)&pStat->idStat); 
if (pStat->idStat.index>—0) 
pStat->pMonitoree - s_pArea + pStat->idStat.index; 

} 

else 

pStat->pMonitoree - (PDW0RD)&pStat->idStat; 
pStat->pNext - s_pStatsList; 
s_pStatsList - pStat; 
return (HSTAT)pStat; // OK! 
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this new statistic will be grouped under. This category will be listed 
in the “Select Category” listbox in SYSMON’s “Add New Item” 
dialog. By default (if you pass NULL), the category is derived from 
the ASCII name of your process’s executable file. For instance, if 
your application is “MyTest.EXE”, the function call 

statCreateC'Foo", MONITOR_VALUE, "This is Foo", NULL); 

would create the item “Foo” under category “App::MyTest.EXE”. 
Although I suggest you use NULL for this parameter, it is possible to 
have complex applications with dozens of statistics, in which case 
custom naming for the categories within the application would 
make sense. 

The typical application flow using the performance monitoring 
DLL looks like this: 

// usually, during initialization: 

HSTAT hStat - 

statCreateC'Foo”, 

MONITOR_VALUE, 

"This is Foo", 

NULL); 

II... 

II main loop (maintaining the statistics): 
statlncthStat, 1); // or statSetthStat, N) 

II... 

II usually, during termination: 
statDestroy(hStat); 


As noted earlier, StatCreate( ) never fails or returns NULL. The phi¬ 
losophy of appstats.dll is that the application using it doesn’t 
require any conditional code related to performance monitoring. It 
is possible that state reate () would be unable to register the statis¬ 
tic with perf.vxd. In fact, in “safe mode,” Windows 95 perfor¬ 
mance monitoring services are not available at all! Certainly, your 
application shouldn’t crash and bum when launched in “safe mode.” 
To circumvent this problem, appstats.dll returns a bogus (but 
valid) HSTAT handle whenever an error occurs at the low level. Thus, 
you needn’t worry about the outcome of statCreate( ); just use the 
handle! If for any reason, however, the caller wants to know 
whether performance monitoring is actually available, he could use 
StatlsInstalledO to check for the availability of the service at 
the low level. 

Example 

To demonstrate the use of the library, I wrote a tiny Win32 console 
application; the source code is in idle.C (Listing 7). The whole pur¬ 
pose of i d 1 e. C is to estimate the degree of “idleness” of the operating 
system in user mode. The algorithm is trivial: the application is run¬ 
ning at the lowest (IDLE_PRIORITY_CLASS) priority level and is keep¬ 
ing track of how much CPU time it is getting. Originally, I planned to 
use Win32’s GetProcessTimes( ) for this purpose. I learned quickly, 
however, that GetProcessTimes () is not supported in Windows 95. 
So, I wrote a rough estimation algorithm which runs a piece of a cal¬ 
culation code at a high ( REA LTIM E_P R10 RITY_C LASS) priority once. 


Listing 6; appstats.c — continued 


) 

else 


return (HSTAT)&s_Dummy; 


// memory problem, use dummy 


/////////////////////////////////////////////////////////// 
// statOestroyO: Destroy a SYSMON statistics item 

U - 

// Parameters: 

// hStat: Statistics handle 

// Returns: 

// TRUE if success, FALSE - bad handle 

APPSTATS_API BOOL _stdcall statDestroytconst HSTAT hStat) 

{ 

PHSTAT.t pStat - (PHSTAT_t)hStat; 

// Remove the stat descriptor from the list and 
// deregister it with the driver: 
if OpStat) return FALSE; 
if (s_pStatsList-—pStat) 

s_pStatsList - s_pStatsLi$t->pNext: 
else { PHSTAT_t p - s_pStatsList: 
while (p) 

if (p->pNext — pStat) 

{ p->pNext - pStat->pNext; break; ) 
else p - p->pNext; 

if (!p) return FALSE; // bad handle 


if (StatlsInstalledO) 

DRIVER_REQUEST(s_hProxyDev, STATDIOC_UNREGISTER_STAT, 
&pStat->idStat, &pStat->idStat, (LPDWORD)&pStat->pNext); 

free(pStat); 
return TRUE; 


/////////////////////////////////////////////////////////// 
// statSet()/Get(): Assign/retrieve the value to/of 

// _——- a statistics item. 

// Parameters 
// hStat 

// dwVal 


Statistics handle 
The value to assign 


// Returns: 

// New value of the statistics item 

APPSTATS_API DWORD_stdcall statSet(const HSTAT hStat, const DWORD dwVal) 


) 


return *((PHSTAT_t)hStat)->pMonitoree - dwVal; 


APPSTATS_API DWORD _stdcal1 statGetCconst HSTAT hStat) 

{ 

return *((PHSTAT_t)hStat)->pMonitoree; 

1 

/////////////////////////////////////////////////////////// 

// statlnc/Dect): Increment/Decrement a statistics item 
// — 

// Parameters: 

// hStat: 

// dwVal: 

// Returns: 

// New value of the statistics item 

APPSTATS_API DWORD _stdcall statlnctconst HSTAT hStat, 

const DWORD dwVal) 


Statistics handle 

The value of increment/decrement 


) 


return *((PHSTAT_t)hStat)->pMonitoree += dwVal; 


APPSTATS_API DWORD _stdcall statDectconst HSTAT hStat, 

const DWORD dwVal) 

( 

return *((PHSTAT_t)hStat)->pMonitoree -- dwVal; 


/////////////////////////////////////////////////////////// 

// StatlsInstalledO: Checks if the AppStats subsystem 

// - ———-—— is available (the proxy VxD is loaded). 

// Parameters: 

// none 
// Returns: 

// TRUE if the AppStats is available. FALSE would mean that 

// the statistics won't be seen at SYSMON; the AppStats API is 

// still safe to use, though,- no conditional code is required 
APPSTATS_API BOOL _stdcall statlslnstalled(void) 

{ return s_hProxyDev !- INVALID_HANDLE_VALUE; ) 

/* End of File */ 
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then switches to the idle priority mode and runs the same code in an 
infinite loop. The relative speed of the execution is a rough estimate of 
the CPU load in user mode. 

idle, exe maintains two statistics: hs Idl e, which represents the 
estimate of percentage idleness, and hs Rate, which represents the 
execution speed of the while loop. Figure 3 shows a snapshot of the 
resulting SYSMON charts. This snapshot was taken shortly after I 
started Microsoft Word while idle. exe was running. Notice the 
valleys in the charts for idle, exe’s “User Idle” and “Speed” statis¬ 
tics, which, by the way, coincide with the peaks of the memory 
manager’s “Page Faults” statistics. This demonstrates how you can 


use SYSMON to examine the correlation between your applica¬ 
tion’s performance and the system’s performance. 

Other Issues 

SYSMON is just a user interface to the data in the registry. You 
could write your own custom tool to read statistics from the reg¬ 
istry and write them to a database or log file. Because the perfor¬ 
mance monitoring API is completely separate from the software 
that monitors it, you can decide whether and when to monitor with¬ 
out making any changes to your application. 

One limitation of this performance monitoring technique is that it 


Table 1: 

The basic appstats.dll API 

Function 

Parameter 

Description 

statCreate() 

szName 

String containing name of new statistic. 


stType 

MONTTORJVALUE or MONITOR_RATE. 


szDescription 

String description of this statistic. 


szCategory 

String name of category (NULL is OK). 


returns 

A handle to the new statistic. 

statDestroyO 

hStat 

A handle obtained from statCreate(). 


returns 

TRUE if successful, FALSE otherwise. 

statGet() 

hStat 

A handle obtained from statCreate(). 


returns 

The current value of the statistic. 

statSet() 

hStat 

A handle obtained from statCreate(). 


dwVal 

The new value for the statistic. 


returns 

The new value of the statistic. 

statlsInstalledO 

<none> 

returns 

TRUE if the statistics should be visible 
via SYSMON; FALSE otherwise. 
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won’t work under Windows NT. NT has a different performance 
monitoring model than 95, and VxDs are unknown animals to NT. 
However, since the DLL is designed to work correctly even if the 
VxD cannot be loaded, any application using appstats .dll will still 
work under NT — it just won’t produce any actual statistics. Note 
that Windows NT provides much more sophisticated services for 
performance monitoring for both user and kernel mode components. 
NT also comes with a statistics viewer utility called Performance 
Monitor. The Performance Monitor is similar to Windows 95’s 
SYSMON, but it delivers many other advanced features, such as 
remote control, database connectivity, reporting, and alerting. 


SYSMON was designed to monitor Windows 95 statistics that 
exist throughout the lifetime of a Windows session — the “kemel”- 
level statistics. Application-level statistics are dynamic by their nature 
— they come and go as the applications do. SYSMON is not smart 
enough to figure out that a statistics item it had been commanded to 
monitor has been de-registered; SYSMON keeps rendering the chart 
as a straight line after your application terminates. What would be 
helpful is a way for perf .vxd to signal SYSMON when a statistics 
item is created or destroyed. This could be done, for instance, by using 
some predefined keys in the HKEY_DYN_DATA subtree of the registry, 
which would be periodically polled by SYSMON. 


Listing 7: idle.c — An example of creating custom 

hsldle - statCreateC'User Idle”, MONITORJALUE, 

SYSMON statistics 

"Estimates User Mode Idleness, l" , NULL); 

1 // Idle.c -- sample Win32 console app using APPSTATS library 

hsRate - statCreateC’Speed", M0NIT0R_RATE, 

"Estimates how fast we're running", NULL); 

#1 Delude <windows.h> 

'/Induce <conio.h> 

if(lstatlsInstalledO) 

(/include <stdio.h> 

printf("Unable to install statistics ! \n") ; 

| (/include "appstats.h" // Stats API declarations 

// monopolize the CPU for a while and see what we get 

SetPriorityCIass(GetCurrentProcess(), REALTIME_PRIORITY_CLASS) ; 

1 DWORD Speedtvoi d) // wastes time and returns a ///msec 

dwMaxSpeed - Speed!); 

1 { DWORD dwTime - GetTickCountt): 

| DWORD volatile i ; 

// get idle and monitor what we're getting 

SetPriorityCIass ( GetCurrentProcess () , IDLE_PRIORITY_CLASS) ; 

j for (i-0; i<1000000 : 1++); 

while (IkbhitO) { 

5 return i /( GetTickCountt ) -dwTime+1 ); 

statSet!hsldle, 100*Speed( ) /dwMaxSpeed ); 

1 1 

statlncthsRate, 1); 
printf (".”); 

| void main!) 

1 

1 ^ 

HSTAT hsldle; // idle time stats 

statDestroy(hsIdle); 

HSTAT hsRate; // running rate stats 

statDestroy(hsRate); 

DWORD dwMaxSpeed; 

1 

/* End of File */ 
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Conclusion 

I used Visual C++ v4.0 to build statprox. vcd; Visual C++ 
v4.1 has a bug that makes it difficult to use for building VxDs. 
The sample application, however, was built and tested with both 
Borland C++ v5.1 and Visual C++ v4.2. The code disk contains 
import libraries for both those compilers that will let you easily 
access appstats.dl1. 

This article presents a way for Win32-based applications to 
inspect and monitor their internal dynamic parameters using a 
standard system tool — the Windows 95 System Monitor. The 
described API, implemented in a Win32 DLL, provides a simple 
and non-intrusive way to collect and analyze application perfor¬ 
mance data using System Monitor’s charts. This tool can be used 
as an enhancement to the arsenal of more traditional debugging 
and profiling tools to make it easier to debug and fine-tune 
Win32-based applications. 
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Key Points 


• Windows 95 supplies a useful accessory (SYSMON) for moni¬ 
toring various system statistics, but it doesn’t install it by default. 

• SYSMON is merely reporting on data it reads from the dynamic 
portion of the registry. That data is getting put there by a built-in 
VxD called perf. vxd. 

• perf .vxd exposes an interface for defining your own custom 
statistics, but that interface is available only to other VxDs. The 
VxD and DLL included with this article lets any application that 
can call DLLs create its own custom statistics that can be viewed 
with SYSMON. 



Figure 3: Viewing custom statistics in SYSMON 
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A Simple Line Length Limitation Trick for Edit Controls 

Muthuvale Shanmugam 
103624.1501 @ compuserve.com 

The maximum number of characters that can be entered in an 
edit control can be limited by calling the method Li mi tText () of 
the MFC class CEdi t. In a multi-line edit control, limiting the total 
number of characters is sufficient in most cases. In some cases, 
however, you must limit the number of characters in each line. One 
example is when the contents of the multi-line edit control must be 
copied to a formatted report. 

Windows sets the maximum number of characters in any single 
line to 1,024, and there is no way to change this number to a practical 
value less than 1,024 characters. To limit line length, you can use tech¬ 
niques such as creating a custom multi-line edit control or subclassing 
the Windows multi-line edit control. But if you’re willing to sacrifice 
the undo capability of the multi-line edit control, there is a very simple 
technique you can use to limit line length. 

Class CLEdit is derived from CEdi t, adding the ability to limit 
line length. The maximum line length can be specified during 
OnlnitDialogO of the dialog that owns the instance of CLEdit. 
Note that this is only part of the code that handles the line length 
limit problem (see Figure 1). 

In Figure 1,1 appropriate the undo feature of the edit control to 
limit line length. The undo buffer is always maintained empty. Each 
time a change occurs to the edit control contents, the change is dis¬ 
played. A check then verifies whether or not that change has caused 
any of the lines to exceed the maximum length. If so, then the last 
change is undone. This guarantees that the line length never exceeds 
the specified maximum. 

Note: Every time a typed character or a pasted string causes a 
line to exceed the specified maximum length, the change appears on 
the edit control for a fraction of a second before it is cleared by the 
undo function. I consider this behavior to be an acceptable tradeoff 
for a simple solution. 

Initialization of Static Variables 

Dan Shappir 
shappir@math.tau.ac.il 



non-constant expressions. The benefits of this language extension 
can also be applied to base type variables. Consider a function that, 
given a window handle, places the window in the center of the 
screen. This function needs the screen dimensions. To reduce func¬ 
tion call overhead, you can read these values once and place them in 
static variables. The standard C method is: 


BOOL Center(HWND hWnd) 

{ 

static int W = -1; /* Impossible value. */ 
static int Y; 
if ( W =- -1 ) { 

W - GetSystemMetrics(SM_CXSCREEN); 

H - GetSystemMetrics(SM_CYSCREEN); 

} 

I 


In C++, you can create a simpler and more efficient implementation: 

BOOL Center(HWND hWnd) 

{ 

static int W = GetSystemMetrics(SM_CXSCREEN); 
static int H - GetSystemMetrics(SM_CYSCREEN); 

} 

The initial values of W and H will be computed the first time 
Center () is called. 

Using C++ classes allows for even more efficient use of precom¬ 
puted values. Suppose that the screen dimensions are used by more 
than one function. Rather than repeat the procedure for each function, 
the value can be computed once and used throughout the program: 

struct CScr { 
static int W; 
static int H; 

} 

int CScr::W = GetSystemMetrics(SM_CXSCREEN); 
int CScr::H - GetSystemMetrics(SM_CYSCREEN); 

BOOL Center(HWND hWnd) 

{ 

CScr scr; // Use scr.W and scr.H 


In C, the only way to initialize global and static variables is to 
use constant expressions. C++, however, allows initialization with 


i t v i m Can't find that Tech Tip from a past issue? The Windows Developer's 
LyS Journal CD-ROM with full search capabilities is now available. 
toot I See page 36 for more information. 
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} 

BOOL Ful1 Screen(HWND hWnd) 

{ 

CScr scr; // Use scr.W and scr.H 

} 

Alternatively, Center () and Full Screen () can be defined as mem¬ 
ber functions in the same class and use values stored in the class’s 
data members. 
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Streamlining I/O of Window Placement Data to Disk 

Patrick Tennberg 
100571.1217@compuserve.com 

Sometimes I find it useful to save binary data, such as structures, 
as strings. For example, if you want to save the position, size, and 
state of a window, you can use the Windows function 

GetWindowPlacementthWnd,&wndPlacement); 

to fill in a structure (WINDOWPLACEMENT) containing the window’s 
size, position, and state information. To restore the window, you 
simply need to call the function: 


SetWindowPlacement(hWnd,&wndPl acement); 

This sounds simple enough, but when you look at the WINDOWPLACEMENT 
structure, you’ll see that it contains a lot of fields that you need to 
store individually in the registry or in a .ini file. This requires a lot 
of different key names and a lot of calls to functions to write and 
read the stored fields: 

typedef struct .WINDOWPLACEMENT { 

UINT length: 

UINT flags; 

UINT showCmd: 

POINT ptMinPosition; 

POINT ptMaxPosition; 

RECT rcNormalPosition: 

} WINDOWPLACEMENT: 
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If you could somehow store the entire WINDOWPLACEMENT stmcture 
as one string, then you could save yourself a lot of time. To convert 
binary data to a null-terminated string, you need to store the data as 
valid string characters (don’t use 1 \0' in the middle of the string). To 
solve the problem, I implemented two functions — one to convert the 
binary data into a string and another to reverse the operation: 

void ConvertDataToHext 

const LPSTR source, LPSTR dest, int size): 

This function converts each byte in the parameter source to a two- 
character hex representation in dest. If source contained the binary 
data 255,1,10, then dest would contain the zero-terminated string 
“FF010A”. This solution has the side effect of doubling the size of 
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Figure 1: Sample code to limit edit control line lengths 


//This method should be called every time the dialog box 
//receives ENJJPDATE for this edit control. 

void CLEdit::Update() 

{ 

CString str; 

BOOL bTooLong; 

// Check if a line in the control has exceeded nMaxLength 
// chars. nMaxLength should be specified during dialog's 
// OnlnitDIalog 
bTooLong - FALSE; 
str - GetWindowTextO; 

//Check all lines except the last line 
whi1e((nLength - str.Find('\r’)) !- -1) 

I 

if(nLength > nMaxLength) 

{ 

bTooLong - TRUE; 
break; 

} 


str - str.Right(str.GetLength()-2-nLength); 

) 


//Check the last line as well. 
if(bTooLong || 

(str.GetLengthO > nMaxLength U str[nMaxLength] !- '\r')) 

{ 

MessageBeepiMB ICONHAND); 

UndoO; 

EmptyUndoBufferO; 

} 

else 

EmptyUndoBufferO; 

) 

//End of File 
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the binary data to be converted, so you should not use this solution 
to store very large structures. 

void ConvertHexToData( 

const LPSTR source, LPSTR dest); 

This function reverses the operation by converting the hex string in 
source to a binary representation in dest. You can now finally store 
the spatial information about the window in a simple way by using 
the following code snippet: 


char buffer[50]; 

WINDOWPLACEMENT wndPlacement; 

GetWindowPlacement(hWnd,&wndPl acement); 

ConvertDataToHex((LPSTR)&wndPlacement, 
buffer,sizeof(WINDOWPLACEMENT)); 
WritePrivateProfileStringtszSection, 
szKeyPI acement.buffer,szIniFile); 

To restore the window state, you can use the following code: 


Listing 1: convert.c — Data-to-Hex and back conver¬ 
sion functions 


1 / 

II ConvertDataToHexO and ConvertHexToData!) functions 
II 

[/include <windows.h> 

static LPSTR hexString - "0123456789ABCDEF"; 

//define HexToInt(ch) \ 

(BYTE)(((ch) > '9') ? ((ch) - 55) : ((ch) - '0')) 

// Converts the data in source to a null-terminated hex 
// string in dest. The parameter size should contain 
// the size of source. 

void ConvertDataToHex(const LPSTR source,LPSTR dest.int size) 

{ 

int j = 0; 

for (int i - 0;i < size;i++) 

{ 

BYTE ch - source[i]; 


dest[j++] - hexString[(ch » 4) & OxOF]; 
dest[j++] - hexString[ch & OxOF]; 

1 

dest[j] - '\0'; 

1 

// Converts the null-terminated hex string in source to 
// data stored in dest. 

void ConvertHexToDatatconst LPSTR source,LPSTR dest) 

{ 

BYTE data; 

int len - lstrlen(source), 
j - 0; 

for (int i - 0;i < len;i+=2) 

{ 

data - HexToInt(source[i]); 

dest[j++] = (BYTE)((data « 4) | HexToInt(source[i+1])); 
1 

1 

//End of File 
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char buffer[50]; 

WINDOWPLACEMENT wndPlacement; 

GetPrivateProfileStringfszSection, 
szKeyPlacement,"-".buffer,50,szlni File); 
if (buffer[0] — 

{ 

ConvertHexToData(buffer,(LPSTR)&wndPlacement); 
SetWindowPlacement(hWnd,&wndPlacement); 

} 

The source for the two functions is in convert. c (Listing 1). 


Displaying Simple Debug Strings in VxD Code 

Manish Apte 
manish@querisoft.com 

I have developed a simple VxD, CDEBUGD, which helps VxD writ¬ 
ers display debug strings in their VxD code. CDEBUGD is a dynami¬ 
cally loadable VxD. It provides the VxD service Dbg_Out, which is 
supposed to be called from another VxD. 


VxD developers can use this service to display debug messages 
during the execution of their VxDs. When this service is called, 
CDEBUGD copies the message to its internal buffer (which is a 
linked list of buffers). As messages are sent, they are added to the 
linked list. 

The console application DBGSTART.EXE must be run in order to 
see these message on the screen. If this application is not running, 
CDEBUGD holds the messages in the internal linked list. Whenever 
this application starts, the currently held messages are read and dis¬ 
played by the application. 

To stop DBGSTART.EXE, run DBGSTOP. EXE. I recommend that you 
keep DBGSTART.EXE running all the time, as one or more loaded 
VxDs are likely to use the Dbg_0ut service. CDEBUGD will thus con¬ 
sume less memory. 

To load CDBGD.VXD, run DBGSTART.EXE. You can also load 
CDBGD.VXD statically, which is what I recommend. 

Call the Dbg_0ut service from a VxD as follows: 

.INCLUDE CDEBUGD.INC 


Figure 2: Filling a combobox with ready drives only 


// 

// Function to Fill a Drive ComboBox 
// Only with Drives Ready to Be Used 
II 

void CFooDlg::SetDriveCombot) 

{ 

char szDrive[20]; 
char szBuffer[_MAX_PATH]; 

// Grab Pointer to Drive Combo and Clear It 

CComboBox* pCombo - ( CComboBox*) GetDlgltemC IDC_DRIVE); 

pCombo->ResetContent(); 

// Save Current Drive 

int nCurrentDrive - _getdrive(): 

// Get Drives 

for ( int nDrive - 1; nDrive <- 26; nDrive++) 

{ 

// Check for Drive Change ( Drives are One-Based) 

if( _chdrive( nDrive ) — 0) 

{ 

// Check for Default Directory 

if( _getdcwd( nDrive, szBuffer, _MAX_PATH ) !- NULL ) 
{ 

// Set New String for Combo Box ( as 'Drive X:') 
// Note: Drive Nbr + 64 converts Drive Number 
// to ASCII Character 

wsprintf( szDrive, "Drive %c:", nDrive + 64); 

pCombo->AddString( szDrive); 


// Restore original Drive 

_chdrive( nCurrentDrive); 

// Select Current Drive in Drive Combo 

wsprintfC szDrive,"Drive %c:", _getdrive() + 64); 

pCombo->SetCurSel( pCombo->F1ndStringExactt -I, szDrive)); 
} 

//End of File 


Msg db "Hello World", 

mov eax, 0FFSET32 Msg 
VXDCall Dbg_0ut 


Listing 2: handle.h — Template class for resources 


1 // handle.h 

t 

| tempt ate<ct ass T> 

i class CAuto { // Smart container for closable objects. 

T m_obj; 
public: 

CAutoCT obj - 0) : m_obj(obj) {) 

CAutoCconst CAutoS obj) 

: m_obj(const_cast<CAuto<T>&Xobj).reset()) 0 
-CAuto0 
{ 

if ( get() ) 

Close(getO); 

} 

CAutoS operator=(const T obj) 

{ 

T temp - reset(obj); 
if ( temp ) 

Close(temp); // Close previous object, 
return ‘this; 

} 

CAutoJ operato;—(const CAutoS obj) 

( 

if ( Sobj -- this ) // Avoid self assignment, 
return ‘this; 

return ‘this - const_cast<CAuto<T>&>(obj).reset(); 

) 

T get() const 
{ 

return m_obj; 

1 

operator TO const // Conversion operator. 

1 

return get(); 

} 

T resettconst T obj * 0) 

{ 

T temp - get(); 
m_obj - obj; 
return temp; 

) 


#endif 

// End of File 
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Note: The VxD ID of CDEBUGO is 3000H. If your system has a VxD 
with the same ID, you must recompile CDBGD.VXD. To change the 
VxD ID, save the CDEBUGD. INC file. After CDBGD.VXD is ready, com¬ 
pile your VxD with the updated CDEBUGD. INC. 

If you do not have a VxD with the ID 3000H, you can use 
CDBGD.VXD straight away. Also, if you are loading CDBGD.VXD 
dynamically, make sure that it is loaded before any VxD starts using 
the Dbg_0ut service. CDBGD.ZIP, available in this month’s code 
archive, contains the necessary binaries. 

I thank the technical staff of Software Exports (India) Pvt., Ltd., 
(SEPL) Pune, India for their support in preparing this tip. 


Rather than the HANDLE type member m_handl e, CAutO manipulates 
the member m_obj whose type is given as an argument in the tem¬ 
plate instantiation. For example: 

CAuto<HANDLE> x; 

declares X to be a container of a HANDLE and X.m_obj to have the 
type HANDLE. To use a type as a parameter for CAuto, assigning null 
to a variable of this type must be legal, and an overloaded version of 
the Closet) function must be defined for it. For example, the 
Cl ose () function for the HANDLE type can be defined as: 


Filling a Combobox with Ready 
Drives Only 

Thierry G. Marneffe 
Thierry.Marneffe@ping.be 

The CComboBox documentation states 
that Dirt) adds a list of filenames and/or 
drives to the listbox of a combobox. When 
Dir — used with the flags DDL_DRIVES j 
DDL_EXCLUSI V E — searches for your 
machine’s local and network drives, it 
will return a list of all the drives that 
match the name specified as the second 
parameter of the function. This is true 
even for drives such as floppy. Zip, etc. 
with the media removed. To solve this 
problem, I wrote a small function to fill a 
combobox (with the identifier IDC_DRI VE) 
with only those drives that are ready to be 
used (see Figure 2). 

The CD-ROM drive seems to react dif¬ 
ferently than the other removable drives. 
On my system, they always seems to be 
ready, even when no CD is loaded. 

Avoiding Resource Leaks — Part II 

Dan Shappir 
shappir@math.fau.ac.il 

This Tip is a continuation of my previ¬ 
ous Tech Tip on avoiding resource leaks 
( WDJ , March 1997). In that Tip, I showed 
how to define a smart Windows HANDLE 
container, CHandl e, so that when a contain¬ 
er object goes out of scope the contained 
HANDLE is automatically closed. I’ll show 
how C++ templates and function over¬ 
loading can be used to create a generic 
container type you can use to provide the 
same functionality for other types of 
Windows handles, such as instance han¬ 
dles (HINSTANCE), device context handles 
(HDC), atoms (ATOM), etc. 

Instead of the specific container 
CHandl e, I define a generic container CAuto 
that provides the same member functions. 
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void Close(HANDLE handle) 

{ 

if ( handle ) 

Close(handle); 

} 

C++ function overloading allows the definitions of as many ver¬ 
sions of Cl ose() as is necessary. For example, CAuto () can support 
device contexts by defining the following function: 

void ClosetHDC hdc) 

{ 

if ( hdc ) 

DeleteDC(hdc); 



Note that in order to avoid ambiguities, you may have to define the 
STRICT preprocessor macro. This macro instructs the Windows 
header files to generate distinct declarations for the different types. 

The typedef instruction can be used to declare shorter and more 
readable names for the types generated from CAuto; e.g., 

typedef CAuto<HANDLE> CHandle; 

CAuto can also be used for non-Windows handles such as open file 
handles (FILE *) and even memory blocks allocated from the heap: 

void ClosetLPSTR p) 

// free(NULL) is OK - no need for check. 

{ 

free(LPVOID(p)); 

1 


void footint size) 

1 

CAuto<LPSTR> bar - malloc(size); 

// memory pointed to by bar 
// freed automatically. 

} 

CAuto allows for an efficient style of defen¬ 
sive programming. Instead of chasing down 
resource leaks you can avoid them altogether. 
See Listing 2 (handle.h) and Listing 3 
(test. cpp) for an example program. □ 




Download the code from 
www.wdj.com/source.htm. 


Listing 3: test.cpp — 
Demonstrating CAuto 


I // test.cpp: Dummy sample program. 

I // Starts notepad and waits till it exits, 
fifndef STRICT 
(/define STRICT 
i/endif 

I (/include /windows.h> 

' void Closet HANDLE handle) 

1 

if ( handle ) 

CloseHandle(handle); 

I 1 

(/include "handle.h" 

int WINAPI WinMaintHINSTANCE. HINSTANCE, 
LPSTR, int) 

{ 

CAuto<HANDLE> x; // Create unassigned 
// CHandle object. 

STARTUPINFO si; 

GetSta rtuplnfot&si): 

PROCESSJNFORMATION pi; 
CreateProcesstNULL, "notepad.exe”, 

NULL. NULL, FALSE, 0, 
NULL, NULL, Ssi, dpi); 

// Assign using assignment operator: 
x - pi.hProcess: 

// Assign using constructor: 
CAuto<HANDLE> y - pi.hThread; 

// Closes previous handle in 
// y and also resets x: 
y - x; 

// Use y as if it was a 
//regular HANDLE: 
HaitForSingleObjectty, INFINITE); 
return 0; 

} // Close handle in y. 

// End of File 
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Paula Tomlinson 

Understanding NT 



If you’re like many Windows NT developers, you’ve probably 
considered using a little “security” in your applications but may 
have been discouraged by the maze of imbedded structures and 
bewildering Win32 security API routines. While it’s true that the 
Windows NT security system is very rich and complex, the average 
programmer needs only a basic understanding of how security 
works in order to write more robust and secure programs. If you’re 
developing a complex secured database product, for example, then 
you probably need to know everything there is to know about the 
security system. This column is for everyone else. Following that 
theme, in this month’s column I will describe the basic Windows 
NT security model at the level of detail that most developers will 
ever need. I will continue next month by presenting source code for 
performing common security-related tasks. 

The NT Security Model 

When authors try to explain Windows NT security, they usually 
begin by defining government C2 certification. However, all the 
average programmer needs to know is that on NT, when you create 
an operating system object (a file, registry key, process, semaphore, 
etc.) you can restrict who is allowed to access it (also known as “dis¬ 
cretionary access control”). Developers often equate security with 
protection against malicious access (usually from a remote network 
connection). This is definitely a crucial aspect of Windows NT secu¬ 
rity that may impact everyday programming. For example, you may 
have data files or registry keys that contain some kind of private or 
proprietary information (such as a password or an employer’s 
salary). A perhaps more common aspect of security that affects 
everyday programming is guarding against accidental access. If 
there’s a user-visible object (such as a file or registry value) that you 
don’t want a curious user to accidently delete or modify, then you 
should consider securing it. 

To understand how security works and to use it effectively, you 
need to understand how security is applied to NT users and objects. 
In this case, the user is the person that logged on to the system 
(either locally or remotely) and the object is something that a user 
attempts to access. When a user creates an object, information about 
who is allowed to access it is stored with the object. Whenever a 
user attempts to access that object, the NT security system deter¬ 
mines whether or not to allow access to the object by comparing 
that user with the access information stored with the object. Next I 
will examine both users and NT objects in more detail. 

Users 

The concept of user-based security is confusing to many devel- 

Paula Tomlinson has been developing DOS, Windows and Windows NT based 
applications and device drivers for nine years. The opinions expressed here are 
hers alone. She can be contacted via the internet at paulat@microsoft.com. 


opers. Since it’s really the application that attempts to access the 
object, shouldn’t security be based on the application? For instance, 
can I create an object that only regedt32.exe can access? That is 
certainly possible on UNIX systems, but NT security doesn’t work 
that way. When a user, either locally or remotely, logs on to an NT 
system, the username and password given are validated against a 
database of user account information that the operating system 
maintains. Once the user is validated and the logon is completed, an 
internal access token is assigned to that user and logon session. 
When that user subsequently starts an application, the operating 
system creates a process and assigns the user’s access token to the 
process. Likewise, any processes that are started by the original 
process will inherit the original process’s access token. So, the 
application’s process does have an associated access token that is 
used to control its access to objects, but that access token is based 
on the user account that started the application and not the applica¬ 
tion itself. In other words, you can restrict a certain user from 
accessing an object, but you cannot retrict a specific application 
from accessing an object. For the most part, this access token is 
transparent to both users and programmers. The key point is that 
permissions of any given process depend entirely on which user — 
not which application — spawned that process. 

Note that this has some interesting connotations for services 
which may be associated with a specific user account or with the 
general LocalSystem account. Unlike any other kind of process, a 
service effectively “logs on” as a separate user, and its permissions 
are determined by the account in which it was installed. The 
LocalSystem account is essentially treated like part of the operating 
system and consequently has some special security-related rights 
and privileges. On the other hand, the LocalSystem account also has 
some restrictions that local user accounts don’t usually have (for 
example, the LocalSystem account has strict restrictions on access¬ 
ing network resources). 

In short, the access token has all the information the security 
subsystem needs to determine whether or not a process is allowed to 
access a given NT object. The access token itself contains two types 
of information that programmers need to be aware of: security iden¬ 
tifiers (SIDs) and privileges (see Figure 1). The SID uniquely iden¬ 
tifies a user or group of users. A group is nothing more than a 
uniquely identified collection of users, but it’s a very powerful and 
convenient security concept. Instead of repetitively assigning the 
same rights and privileges to each member of a team, you can sim¬ 
ply create a group that contains each individual user account and 
then assign the appropriate rights and privileges to the group. A user 
account can be a member of more than one group. “Administrators” 
and “Guests” are examples of default groups. The access token con¬ 
tains the SID describing the specific user account as well a SID 
identifying each group which that user is a member of. 
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Access Token 
User SID 

Group SID(s) 


Privileges 



Validate logon, 
create access 
token 


local remote 
logon logon 

A A 

Security 

Account 

Manager 

database 


Figure 1: Access token 


The final noteworthy piece of information in the access token is 
a list of privileges. Privileges are a convenient means of overriding 
specific types of security. A common example of a privilege is the 
“backup” privilege. The user who has the backup privilege gets read 
access to files that he might not otherwise have access to. The same 
thing could be accomplished by modifying the security access 
information associated with every single file on the system, but it’s 
much more efficient to simply give that user a single overriding 
privilege. 

Privileges can be assigned to users as well as groups. A user gets 
the combined privileges of his own user account as well as the privi¬ 
leges of each group he is a member of. The fact that privileges can be 
enabled as well as disabled is also an efficient security feature. Say, for 
instance, that you want user John Doe to 
have all the privileges of the Administrators 
group except for privilege XYZ. You could 










-lint 


for C/C++ 

Version 7.0 

presents Bug # 563 


1 

#include <stdio.h> 



2 





3 

int 

f(int n) 



4 


t 
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int m; 



6 


switch( n ) 
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t 
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case 1: m = 2; 

break; 
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case 2: m = 4 ; 

break; 


10 


case 3: m = 8; 

break; 


11 


delault: m = 0 

break; 
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> 
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return m; 
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> 
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16 

int 

main() 



17 


< 



18 


printf( "f(5) 

= %d\n", f(5) 

); 

19 


return 0; 



20 


> 




This program has an interesting flaw that causes it to print garbage. The flaw is 
sufficiently obscure that the problem was reported to IBM as a compiler bug. Mr. Bernd 
Kunrath of Stuttgart uncovered the flaw by running the code against PC-lint. Can you spot 
it? Call if you need a hint, or refer to our web page at http: / /www. gimpel. com. 


PC-lint for C/C++ will catch this and many 
other bugs. It will analyze a mixed suite of C 
and C++ modules to uncover bugs, glitches, 
quirks and inconsistencies. 

Version 7 of PC-lint breaks new ground with 
inter-statement value tracking for both 
automatic variables and class data members. 
Taking clues from assignment statements, 
initializers and conditional expressions it can 
detect out-of-bound subscripts and potential 
null pointer uses. As an enabling technology, 
almost 100 standard functions are rigorously 
checked. Also macros are subject to increased 
scmtiny, checking for unparenthesized 
parameters, unparenthesized bodies and 
repeated arguments having side-effects. 

Plus Our Traditional C/C++ Warnings: 
Uninitialized variables, inherited non-virtual 
destructors, strong type mismatches, 


inadvertent name-hiding, suspicious 
expressions, etc., etc. 

Full C++ Support - PC-lint for C/C++ 
is based on the ARM and is tracking the 
latest ANSI/ISO draft including exceptions 
and templates. It supports both Borland and 
Microsoft C/C++. 

PC-lintfor C/C++ $239 

Numerous compilers/ libraries supported. 
Runs on MS-DOS (Optional built-in 386 
DOS extender), OS/2, NT and Windows 95. 
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FlexeLint for C/C+ + 

The same great product for other operating 
systems. Runs on all Unix systems, VMS, 
mainframes, etc. Distributed in shrouded 
C source form. Call for pricing. 


PA add 6% sales tax. 


©Imp®] Software 

3207 Hogarth Lane, Collegeville, PA 19426 

CALL TODAY (610) 584-4261 Or FAX (610)584-4266 

30 Day Money-back Guarantee. 

PC-lint and FlexeLint are trademarks of Gimpel Software 


give John Doe membership in the 
Administrators group and then disable that 
XYZ privilege for the John Doe account. 

Members of the Administrators group 
can use the User Manager administrative 
tool (see Figure 2) to assign privileges to 
users or groups. Select “User Rights” under 
the Policies menu. From the “User Rights 
Policy” dialog box (see Figure 3) you can 
enable and disable privileges for various 
users and groups. 


Notice 

To Our Subscribers 

Occasionally, Windows Developer's 
Journal makes its mailing list 
available to vendors of products 
we think our readers will find 
interesting. Current subscribers 
receive free information in the 
mail from these vendors. 

If you prefer that your name not 
be used in these mailings, please 
let us know. Just copy or clip this 
form and send it with your name 
and address to: 

Windows 
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P.O. Box 56565 
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NT Objects 

I’ve been discussing the access token, which identifies who the 
user is, what groups the user is a member of, and what special priv¬ 
ileges the user does or does not have. All that information comes 
into play only when the user attempts to perform some action on a 
particular NT object. Whether or not a user can perform a particular 
operation on a particular NT object depends on both the information 
in the user’s access token, and on the security attached to that spe¬ 
cific NT object. Now I will discuss in greater detail the security 
associated with objects, and how it specifies who can do what with 
an individual object. 

The designers of NT wanted a security system that applied uni¬ 
formly to a variety of different resources, such as files, registry keys, 
semaphores, named pipes, and so on. Internally, NT accomplishes this 
uniformity by having all these resources share a common object struc¬ 
ture. Thus, whether the user attempts to access a file, registry key, or 
any other type of securable object, the same code inside NT gets 
invoked to check whether the operation is allowed. This works because 
all the different kinds of resources internally share the same data struc¬ 
ture. Though the security API itself is not particularly object-oriented, 
the internal implementation is. 

The object manager is the internal NT module that handles cre¬ 
ating, controlling, and destroying NT objects in a uniform fashion. 
Most kinds of NT objects (with the exception of disk files, which 
must always be named) can be either named or unnamed. Since 
object handles are process-specific, the only way an object can gener¬ 
ally be shared is by naming it. For this reason, security is typically 


applied only to named objects. These objects are referred to as 
“securable.” Each securable object has a security descriptor 
attached to it (see Figure 4). Essentially, the security descriptor 
describes who can access the object and in what way. At this point, 
the security descriptor gets a little complicated. It isn’t sufficient to 
say that the John Doe user account is allowed to access object XYZ. 
The operating system must keep track of exactly how John Doe is 
allowed to access the object. For instance, John Doe may be allowed 
to read the object but not to write it. 

The pieces of the security descriptor that programmers care most 
about are the owner SID, which describes who owns the object, and 
the Discretionary Access Control List (DACL). The System Access 
Control List (SACL) controls security auditing and is generally a 
more advanced feature of Windows NT security, so I won’t discuss 
it further this month. 

Security descriptors always have an owner (represented by the 
owner SID). The default owner (if no owner was specifically desig¬ 
nated when the object was created) is the user SID from the access 
token of the process that created it. In other words, if you create a 
new file from within your favorite word processor, your SID 
(remember, the SID uniquely identifies who you logged on as) will 
be stored as the owner SID of that file. Ownership is not necessarily 
permanent, however, as users can take ownership of objects they 
didn’t create. For security reasons, a user can’t assign ownership of 
an object to another user. The owner can be either a specific user 
account or a group account. Object ownership is important because 
the owner of an object always has certain access rights to that 
object. I will discuss this further in next month’s column. 
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The Discretionary Access Control List 
(DACL), shown as the last field in the securi¬ 
ty descriptor in Figure 4, is the real meat of 
the security descriptor. As the name implies, 
the DACL is essentially a list of items that 
control access to the object. This list is com¬ 
prised of zero or more Access Control 
Entries (ACEs). It’s the individual ACE that 
actually specifies who can access the object 
and in what way. Again, for efficiency and 
convenience, the ACE can be used to either 


grant or deny access to a user or group. As I 
mentioned previously, it’s not enough to just 
list the user or group that is being granted or 
denied access; the ACE must specify what 
type of access it is allowing or disallowing. 
As you might expect, the ACE contains a 
SID to describe the user or group that is 
being granted or denied access. A simple bit- 
mask is used in the ACE to specify what type 
of access is being granted or denied. Finally, 
the ACE contains a Boolean flag that speci¬ 


fies whether it is granting or denying the 
specified access. Since there can be multiple 
ACEs in the ACL, it’s possible to very pre¬ 
cisely control access to the object. For exam¬ 
ple, the first ACE might specify that user 
John Doe has been denied write access to this 
object. A second ACE might specify that the 
Administrators group has been allowed both 
read and write access to this object. 

When a process attempts to open an 
object for a specific type of access, the 
operating system walks the list of ACEs in 
the order they appear in the DACL. The 
SID and access mask in each ACE are com¬ 
pared with the requested type of access and 
the access token of the calling process. The 
list of ACEs is walked and compared until a 
positive grant or denial of access is made. 
Therefore, the order of the ACEs is very 
important. For instance, it does no good to 
grant read and write access to an entire 
group in the first ACE and then deny write 
access to a specific user in that group in the 
second ACE. The operating system will 
already have decided that the user has been 
granted access and will stop searching the 
rest of the ACEs. The opposite also applies; 
once an ACE has denied access to the 



Figure 2: The User Manager main window 
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At last count, it takes about 217 people to 
design, produce and market 
a killer game. 


However, it still only takes 
one conference. 
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requesting process, no subsequent ACE in the list can counter that 
decision. If the end of the ACE list is reached and access has still not 
been granted, then access will be denied. 

To Be Continued ... 

This brief introduction to Windows NT security is all the theory 
that many programmers will ever need. In next month’s column, I will 
put this theory to practice and explain how to use the Win32 security 
routines to make even simple programs more secure and robust. 

Further Reading 

Asche, Ruediger R. “The Guts of Windows NT Security,” MSDN 
CD-ROM. 



Figure 3: Enabling and disabling user/group privileges 


Asche, Ruediger R. “Security Bits and Pieces,” MSDN CD-ROM. 
Asche, Ruediger R. “Windows NT Security in Theory and 
Practice,” MSDN CD-ROM. 

Nefcy, Christopher. “Windows NT Security,” MSDN CD-ROM. 
Reichel, Rob. “Inside Windows NT Security.” Windows/DOS 
Developer’s Journal, April and May 1993. □ 
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Figure 4: Security Descriptor key fields 
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The documentation states that the message is 
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activation is asynchronous — the activating 
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occur later. 


Reference: MSDN KB Article Q135785 


Submitted by V. Ramachandran. 
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If you discover a bug in the latest version of 
your favorite compiler, email it to us at 
wdletter@mfi.com. Please specify which ver- 
your compiler you are using and include a tiny 
program that demonstrates the problem, along with the 
exact command-line options needed to compile it. 



sion of 


Mark Nelson 

Bug++ of the Month 


As you are reading this. I’m rapidly approaching the 15th 
anniversary of the day I left behind an expensive habit: smoking. 
Unfortunately for me, the money I’m saving on cigarettes is now 
being spent on an equally pernicious habit: the Microsoft Visual 
C++ Subscription. If I don’t get my fix of a new CD with an update 
on it every three months, I break out in cold sweats, get the shakes, 
and sometimes even start hallucinating. And that’s just the way 
Microsoft wants it. 

The 4.2 Fix 

I was excited when I got my 4.2 update of Visual C++. This new 
release promised improved support for the Standard C++ Library, 
including the STL. That, combined with bug fixes and improved 
support for ActiveX controls, made me feel pretty good. 

As it turns out, Microsoft seems to have created new versions of 
most of the C++ library in this release, meaning major changes have 
taken place. Strangely, they continued shipping the old library. For 
example, if you use a #i nclude <iostream.h> statement in your 
source files, you invoke the old library code. Change the statement 
to read #i ncl ude <i ostream), and you will find yourself using the 
new library code. But don’t mix the two — they seem to be incom¬ 
patible with one another. 


the problem. It wasn’t necessary to actually use any vector objects; 
just the presence of the header file was enough to cause the problem. 

An Example 

apr97.cpp (Listing 1) shows my recreation of Dave’s bug. It’s a 
simple program, and despite the fact that it includes <vector>, it 
doesn’t actually use any of the STL. Nonetheless, an attempt to com¬ 
pile the program with VC++ 4.2 generates the error Dave found. 

Steve Ross from Microsoft was willing to admit that things 
looked awry: 

I did get different error messages depending on whether <vector> was 
included or not. This may be a compiler bug in 4.2. If it is determined 
to be a bug, we will hunt it down and fix it for an upcoming release. 

Dave will receive a WDJ t-shirt as an award for his diligent com¬ 
piler testing. This probably won’t make up for the frustration he 
encountered while finding and then working around this bug, but at 
least he’ll have a tangible token of our appreciation. 

If you detect a bug in your C++ compiler, be sure to drop us a 
line. If we use your bug in this column, you’ll not only see your 
name in print, you’ll also get to strut about in a stylish WDJ t-shirt. □ 



STL Versus CString 

Using the STL with Visual C++ 4.1 was not a fun experience. 
Numerous hacks and workarounds were necessary for VC++ to 
work with the free HP distribution. The prospect of an integrated 
STL that works well with the rest of the library was tantalizing. 

But, as WDJ reader Dave McAlpin discovered, there are still a few 
glitches between the old and the new. Dave was attempting to use the 
handy vector class from the STL, when out of left field the compiler 
began reporting problems with manipulations of CSt ri ng objects. Dave 
found that the simple line of code comparing two CStri ng objects 

foot CString &a, CString &b ) 

1 

if ( a != b ) 


generated the following error message: 

error C2373: '!-' : redefinition; \ 
different type modifiers 

Yes, this is a very confusing error message! It took Dave some time to 
determine that simply including the <vector> header file was causing 

rmr* Can’t find that bug from a past issue? The Windows Developer’s 
LyS Journal CD-ROM with full search capabilities is now available. 

VStM. See page 36 for more information. 


Mark Nelson is a partner in Addisoft Consulting, located in Addison, Texas. 
Addisoft provides programming services for a wide variety of C and C++ pro¬ 
gram development tasks. You can reach Mark at markn@addisoft.com, or at 
http://web2.airmail.net/markn. 
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Download the code 


from www.wdj.com/source.htm. 


Listing 1: apr97.cpp 


iff 

| // APR97.CPP 
1 " 

l II Microsoft made major changes to their implementation of the C++ standard 
I // library in their 4.2 release. Unfortunately, some of the changes appear to 

1 // have broken existing classes. For example, including the vector header file 

1 // in this program causes an attempt to perform comparisons of CString objects 
// to fail. 

// 

// In this particular example, I compile the program 
// from the command line using the following command: 

II 

II CL /GX apr97.cpp mfc42.1ib 
II 

II The compile fails with an error C2373, saying that has been redefined 

// with different type modifiers Changing the arguments to foot) to be const 

// fixes the problem, as does removing the include of vector. 

// 

#include <afx.h> 

#include <iostream> 

#include <vector> 

void foo( CString &sl, CString &s2 ) 

I { 

if ( si !- s2 ) 

cout « "Mismatch\n"; 

I ) 

mainO 

{ 

CString a - "a"; 

CString b - "b"; 
foo( a, b ); 
foo( a, a ); 
return 1; 

} 

//End of File 
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First Impressions of Recent Titles 


Java Database Programming 
Brian Jepson 
485 pages 

John Wiley & Sons, Inc. 1996 
$29.95 

ISBN: 0-471-16518-2 



[Note: this review was provided by Victor Volkman.] Java 
Database Programming by Brian Jepson brings together various SQL- 
based access techniques including JDBC, Msqljava, and his own 
homegrown tinySQL for Java. The Java Database Connectivity 
(JDBC) standard is a class library specification developed by JavaSoft 
which provides a uniform, vendor-independent method of transmitting 
SQL to a database engine. JDBC may or may not be implemented as a 
layer on top of ODBC, depending on which third-party solution and/or 
back-end DBMS you are using. mSQL is a relatively inexpensive 
DBMS that runs on a variety of UNIX systems and Win32. Msqljava 
is, of course, the Java interface for mSQL (included at no extra cost). 
Jepson also explains how to write a JDBC driver, presumably to help 
make your own proprietary system interface well with Java. 

The preface is by far one the scariest parts of the book. Here you 
learn that the author is a Beatles fan (which explains the nonsequitor 
lyrics snippets here and there), how he slaved three months to write 
the book, and how he disapproves of flourescent lights. The Beatles 
lyrics and hip joking style continue throughout the remainder of the 
text. It seems that enduring jest is the price we must pay to obtain 
technical information in the 90s. 

Jepson leads off with a breathless explanation of relational data¬ 
base technology, the normalized forms, and all of SQL in just 15 
pages. Unless you’re already familiar with SQL, you should stop 
here and invest in a real SQL primer. The rest of the book is devoted 
to SQL implementations of one variety or another. On the subject of 
SQL, the author stumbles only on the topic of security. He claims 
that stored procedures are an ideal proxy for database security. In 
reality, database security is maintained by GRANT and REVOKE 
privilege commands (which are omitted from discussion). 

The how-to coverage of JDBC consists of a few short samples 
showing various SQL commands invoked followed by an unin¬ 
spired “cardfile” sample. The cardfile demonstrates SQL INSERT, 
UPDATE, SELECT, and DELETE as well as a method of binding 
input fields to database columns. Chapter 5, which attempts to lay 
on a hierarchical model to a relational DBMS, is only marginally 

Got an opinion about these or other programming books? Send them to 
RonBurk@compuserve.com. You can order any of the books that appear in 
Books in Brief from Miller Freeman, Inc. by calling (913) 841-1631, faxing 
(913) 841-2624, or sending email to orders@mfi.com. If using fax or email, 
send the book title, author, and publisher along with your MasterCard, Visa, 
or American Express number expiration date, and phone number. 

To submit books for review, send them to: Ron Burk, 13846 NE 60th Way, #120, 
Redmond. WA 98052-4542. Please do not send press releases to this address. 


Ron Burk 

Books in Brief 



more interesting. Jepson seems to be exhausted in terms of prose 
about 125 pages into the book. Beyond this is some 200 pages of 
virtually unbroken Java code (tinySQL et. al.) with rarely a para¬ 
graph in between. Between white space, line spacing, and com¬ 
ments, the code amounts to a bare 6 to 15 lines per page. 

Since the tinySQL implementation includes only a flat text file 
and . dbf drivers, its use is purely for academic purposes. No serious 
database developer would produce a database with more than a few 
thousand rows that didn’t even support indexes. tinySQL shares a 
gaffe in common with the DBMS I wrote for a college class ten 
years ago: the SELECT statement produces a Cartesian cross-prod¬ 
uct as the first stage in the JOIN processing pipeline. For example, if 
you are joining a customer table with 100 rows, a product table with 
50 rows, and a salesman table with 75 rows, then your intermediate 
result will contain 375,000 rows. Continuing the example and 
assuming 100 bytes per row, you’ve just asked for 37.5Mb of RAM 
because tinySQL holds the intermediate result in memory only. To 
further protect you from unleashing tinySQL on your customers, it 
is protected by GNU Public License, Version 2. 

Java Database Programming mercifully does not include a 
CD-ROM. Instead, all of the code can be downloaded from 
www.wi 1 ey. com/compbooks/jepson. The Java code amounts to about 
750Kb when extracted from the archive and is organized by chapter. 

Jepson finishes with 100 pages of appendices that enumerate 
every single function in the JDBC interface, set in large type and 
full of unhelpful descriptions like: 


getMaxCursorNameLength(): This returns the maximum length of a 
cursor name. 


Despite appendices, this is most definitely a tutorial rather than a 
reference book. 

Overall, I can only recommend Java Database Programming to 
developers with an overriding interest in developing JDBC drivers 
of their own. Anyone in such a position will surely find something 
of value in here. This is a smaller audience than intended, but main¬ 
stream DBMS application developers will definitely do better with 
other resources than this book. 


Building Internet Applications with 

Delphi 2 

Davis Chapman 

593 pages, includes CD 

QUE, 1996 

$49.99 

ISBN 0-7897-0732-2 


lMIRM’T 

\ITIJCVII0\S 


[Note: this review was provided by George Tylutki.] Several 
Delphi books cover aspects of programming for the Internet. 
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There are two chapters on CGI programming in Delphi 2 
Unleashed , but you must download components from a Web site 
to implement the BDE CGI application. Kick Ass Delphi 
Programming has two good chapters on WinSock and FTP in 
which an object encapsulating WinSock is created and a basic FTP 
client is constructed. Delphi 2 Developers’ Solutions contains 
three chapters on Internet programming: a WinSock component is 
created and used to implement a basic FTP client. Usenet NNTP 
and POP3/SMTP clients are also built. The explanations are thor¬ 
ough and lots of code is included. Building Internet Applications 
with Delphi 2, however, is the first book I've come across that is 
entirely devoted to the topic. 

The intended readers are “programmers already experienced 
with Delphi” who are Internet programming novices. However, 
the material has not been “dumbed down.” Chapman moves from 
the basic and theoretical to the advanced and practical. He aims to 
explain “the principles of Internet application programming” and 
provide “sufficient practical examples of these principles at 
work.” That is, he assumes the reader wants to understand 
Internet programming, not just to be shown how to put together 
an email client, for example. The first two chapters are a general 
introduction to programming for the Internet. In Chapter 3, 
Chapman explains IP, TCP, UDP, ICMP, DNS, SLIP, and PPP. In 
Chapter 4, he examines TIME, SMTP, POP3, FTP, NNTP, and 
HTTP (and analyzes sample conversations generated by each). 
Chapter 5 covers TCP/IP ports and sockets and Chapter 7 


Bug Management a Pest? 
Give PR-Tracker a Test! 

Problem Tracking 
for Windows* 

Windows '95 and 
Windows NT 

• Records bugs as 
problem reports in a network 
database 

• Supports simultaneous access by 
multiple users 

• Features classification, assignment, sorting, 
searching and estimation 

• Supports project by project data entry 
Download PR-Tracker for evaluation 

http://www.halcyon.com/softwise/download.html 
CompuServe: CaseForum: prtrack.zip 
By Softwise softwise@halcyon.com 

http://www.halcyon.com/softwise/prtracker.html 
phone: 206-513-0415 fax: 206-513-0516 
o Request Reader Service #145 □ 


explains the various Internet communication standards and how 
they are created. 

The author devotes most of the rest of the book to creating work¬ 
ing applications. In Chapter 6, he constructs a basic WinSock object 
which is used to build an FTP client and an FTP server (Chapter 8), 
an SMTP send-mail client and a POP retrieve-mail client (Chapter 
9), and a Usenet news client (Chapter 10). In Chapter 11, he 
explains UUEncoding and Base64 (MIME) encoding, and builds 
encoder/decoder applications. Chapman covers the WinCGI specifi¬ 
cation and creates a WinCGI component (Chapter 13) and uses it to 
build a CGI application (Chapter 14) that interacts with a database 
(including adding records, querying, searching, and dynamically 
presenting the data on an HTML form via a table). He constructs a 
“robot” that tests Web pages to verify the embedded links and an 
HTTP server that handles CGI requests in Chapters 15 and 16. In 
Chapter 12, he provides an overview of HTTP, HTML, CGI, Java, 
and JavaScript, and in Chapter 17 examines network security (fire¬ 
walls, filters, etc.) and transaction security (encryption and authenti¬ 
cation), explaining RSA, SSL, STT, and PCT. Chapter 18 explains 
controlling the Netscape browser using DDE and OLE. 

Each project is basic and is limited in one or more ways. For 
example, the newsreader can’t save or send articles and the Web 
server supports only one connection. Chapman acknowledges the 
limitations and indicates how the projects could be improved. His 
purpose is not to provide a few complete, polished applications, but 
to teach the basics of most forms of Internet programming. The pro¬ 
jects are compatible with 16-bit and 32-bit Delphi unless they 
exploit or deal with some feature or limitation of one or the other. 
For example, the Netscape OLE automation projects are 2.0-com- 
patible only. Chapman’s code is clear and well-commented. There is 
a standard software license (use on a single computer, one backup, 
etc.), but Chapman says repeatedly that you may use and improve 
his code. 

Appendix A covers the command sets and reply codes of the 
FTP, SMTP, POP, NNTP, and HTTP protocols. Appendix B 
explains the formats of SMTP Mail Headers, Usenet News Headers, 
and HTTP Headers. Appendix C includes a 14-page list of RFC, 
STD, and FYI documents, and how and where to obtain them. 
Appendix D, “Converting from C and C++ to Object Pascal,” is too 
brief (10 pages) to be really useful. Appendix E provides a useful 
description of each item on the CD. Often the CDs that accompany 
books are filled with whatever the authors and editors can find, but 
the items on this CD were obviously chosen carefully. In addition to 
the book’s code, the texts of relevant RFCs, STDs, FYIs, and other 
documents are included. There are also many components and 
applications: utilities for compressing and encrypting files, and for 
viewing, editing, and converting HTML documents; newsreaders; 
Web browsers and servers; FTP clients and servers; Gopher clients; 
email programs; and much more. 

The “About the Authors” section includes six authors other than 
Chapman, but there is no indication what their contributions to the 
book were. The writing is clear and grammatical, although there is a 
bit too much repetition and too many cliches. Lots of electronic 
addresses are included via which you can direct questions, down¬ 
load code, and obtain the latest versions of the items on the CD. 

Chapman exceeds his goal of providing “a starting point from 
which you can gain an understanding of the fundamentals of 
Internet programming and how you can apply those principles 
using Delphi.” 
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Kick Ass Delphi Programming 
Don Taylor, Jim Mischel, John 
Penman, Terence Goggin 
Coriolis, 1996 
506 pages, includes CD 
$39.99 

ISBN 1-57610-044-8 


[Note: this review was provided by George Tylutki.] Kick Ass 
Delphi Programming is not a good investment for two reasons. First, 
at least Chapters 4, 6, 7, and 8 were previously published in Visual 
Developer (formerly PC Techniques) as articles or “Hax” (short 
solutions to specific problems). If you are a Visual Developer sub¬ 
scriber, you have already paid for over 100 pages of the book. There 
is no indication anywhere that some of the material is recycled. 

Second, it is not what its covers claim it to be: “Advanced every¬ 
thing — with an attitude!” and “the most advanced Delphi topics ever 
before collected between covers, explained by the gums for the 
experts.” If there were five levels of programming expertise (with 1 
being novice and 5 being expert), then some chapters are barely level 
2, and a couple are level 4 with most in the 2-3 range. Clearly, the book 
wasn’t written for “experts”: “You use DLLs every day in your normal 
Windows programming, probably without even knowing it” and “You 
can’t ran the DLL — [sic] you need another program to call it.” 

Each chapter was written by one or two authors — eight 
authors total, although the title page lists only four. The quality of 
the writing varies; at its best it’s fair, and at its worst it’s cliched 
and ungrammatical. 


Although some of the chapters are pretty good, the book gets off 
to a bad start. You might expect that a chapter entitled “32 Bit Console 
Applications” would focus on the Console API, but it’s about parsing 
the command line and writing filter applications. On page 9, the 
author explains that “we don’t have space here to discuss the Console 
API,” so the Console API coverage consists of an instruction about 
which option to check when creating a new project (“Generate con¬ 
sole application”). The filter program could just as easily be a DOS, 
console, or GUI application. Because he opts not to use pointers, the 
record structure he uses is “pretty inefficient.” Further, the maximum 
length of the Pascal strings he uses to store the command line is 
shorter than the maximum length of a Windows path. As a quick 
hack, this is acceptable (he’s right when he says that few people will 
type a 260-character command line), but not in a book billed as 
“advanced everything.” Finally, he tells us that he avoids typecasts 
“because, in general, typecasts are considered bad programming 
practice.” He doesn’t say by whom, but Borland's Object Pascal has 
built-in safe typecasting of objects via the a S operator, and the Visual 
Component Library wouldn’t exist without typecasting. 

Chapter 2, “Drag-and-Drop the Windows Way,” has its prob¬ 
lems, too. The author explains at the end of the chapter that he had 
intended to do much more but was unable to get everything working 
“under Delphi in time to meet the deadline for this chapter,” so he 
covered only how to implement drag-and-drop from File Manager 
and Windows Explorer (not OLE drag-and-drop). Chapter 6, 
“Fractal Landscapes,” is not about programming with Delphi, but 
about landscape fractals, and I found the explanation nearly incom¬ 
prehensible. The demo program originated as a DOS program years 



Communications 

Do you need to make your Application communicate over a COM 
port? You need to send messages to electronic pagers? You need to 
clear credit cards using the VISA protocol? Need your Data Base to 
be a client or server or transfer data files? Need to have your 
application talk to a modem, a mainframe, another PC, an electronic 
pager, a bank, or custom hardware? Now you can do this and more 
using CrystalCOMM. You need the unusual? We do it, 

CrystalCOMM for Windows $175 

CrystalCOMM supports development of modem or serial port 
communication programs from your application. CrystalCOMM is a 
DLL that supports XMODEM, ZMODEM, KERMIT, CompuServe, 
VISA, TAP electronic pager, and ASCII protocols through a simple, 
structured function interface. Supports up to 9 ports at high speed. 
Examples include client-server queries over communications links. 
Library includes DLLs, examples, and documentation. Use our 
CrystalCOMM for NT/WIN95 version to run your 32 bit NT or 
WIN95 application program on up to 128 ports concurrently. 
CrystalCOMM for NT/WIN95 - $200. 

Visit us at: www.crystalcom.com 


crystal 

Software ( 906 ) 822-7994 

Inc. 

P.O. Box 247, Amasa, MI 49903 , USA - FAX (906) 822-0219 
crystal@up.net 
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ago and it still struggles to deal with 64Kb segment limitations. 
Chapter 7 is composed of eight short topics (originally Hax in 
Visual Developer ), including taking a snapshot of the screen and 
enabling an application to function as its own setup program. In 
Chapter 8, a Win 3.1 screen saver is created. Chapter 10 covers 
some aspects of dynamic user interfaces (for example, changing the 
sizes and positions of controls at runtime). 

Some of the chapters are quite good. In Chapters 4 and 5, a 
WinSock component is created and used to construct a basic FTP 
client component. The discussion is good but should be longer. 
(Coriolis books use a large font, wide outside margins, and lots of 
white space, so 50 pages isn’t as much as it may appear.) Two chap¬ 
ters cover topics I haven’t seen discussed in other Delphi books. 
Chapter 9 investigates Delphi’s math unit, which includes statistical, 
trigonometric, arithmetic, and financial functions. The author 
describes a bug in the unit and reveals an undocumented function 
that solves polynomials. There is a useful discussion of “handling 
hierarchical data within Delphi databases” in Chapter 11, and the CD 
includes data-aware components for manipulating hierarchical data. 

The last four chapters are a narrative involving Ace Breakpoint, 
private investigator turned programmer. The purpose of Ace’s first 
adventure (in Delphi Programming Explorer) was to teach database 
programming using Delphi via a narrative tutorial. The new adven¬ 
ture has no single focus and thus covers a little of this and a little of 
that — from the very basic (using PlaySound to play a .wav file) to 
the sophisticated (using shared memory, semaphores, and a DLL to 
transfer messages between applications). 

More than one chapter makes use of third-party components for 





The Component for Interactive Audio 

DiamondWare's Sound ToolKit 
for Windows mixes 16 



sounds, with individual pitch and 
L/R volume control, automagically 
converts between 8- and 16-bit, mono 
and stereo, runs under all versions of Windows 
(including Win32s), and works with every 
language you'd ever use to develop games (and 
some you wouldn't). It's only $250, royalty free. 
It's so good that we put a fully-functional demo 
version on our web site. What else need be said? 
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which source code isn’t provided; this limits their usefulness. The CD 
contains the book’s code, WinG and Win32 libraries, shareware and 
freeware VCL components, VBXs, commercial demos, and sample 
articles from Visual Developer. There is no code use statement in the 
book and many of the code listings have copyright notices. However, 
most of the authors make it clear that they expect you to use their code. 

There is quite a bit of useful information in this book, but 20 per¬ 
cent of it is recycled and 20 percent is basic, level-2 material. If you 
feel that “it’s time to take off the gloves and go for the throat” because 
“you’re through learning Delphi and ready to kick you-know-what” 
then you may want to pick up Kick Ass Delphi Programming. 


And Keep in Mind 


The Revolutionary Guide to Delphi 2 

Paul Hinks, Douglas Horn, Arjan Jansen, Dave Jewell, Brian 
Long, Ewan McNab, Bob Swart, William Wako, Colin Winning, 
Wrox Press, 1996, 691 pages, $49.95, includes CD, 

ISBN 1-874416-67-2. Reviewed September 1996. 

The book is uneven. Too many topics are given too few pages: writing 
database applications, the BDE, ReportSmith, and SQL and 
InterBase. However, several parts are quite good: the chapters and 
sections on debugging, Delphi Experts, interfacing with other applica¬ 
tions, optimizing applications, and components. Chapters 2 and 3 
constitute a useful 90-page language reference and the chapter on the 
Windows API is especially useful to new Windows programmers. The 
quality of the writing is at best average. The CD contains the entire, 
searchable text of the book. Although somewhat repetitious and unor¬ 
ganized, this is a useful, general, non-introductory book on Delphi. 


1 

0 

Let’s Talk Books 



From: djohnson@salix.com (Dave Johnson) 
Subject: book recommendation? 

Hello Ron. 




SDK Annotation #180 


TYPE: Win32 

TOPIC: DRAWITEMSTRUCT 
KEYWORD: DRAWITEMSTRUCT 


Listviews always set the itemAction member to 
ODA_DRAWENTIRE. You need to check the 
itemState member to check if the focus or 
selection needs to be updated. 

Reference: MSDN KB Article Q131788 

Submitted by V. Ramachandran. 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications” 
of forum SDFORUM). Contribute your own annotations via 
email to RonBurk@compuserve.com (indicate which topic in 
which help file you are annotating). 
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I need to give a high-level presentation of object-oriented design 
principles to a client of mine. It will be a classroom situation with 
five to ten people (including both C programmers and non-develop¬ 
ers). It will be a pretty generic presentation of one to two hours, so I 
obviously won’t be going into great detail. 

Are there any good object-oriented design books that you might 
recommend to me? I have been designing and developing C++ 
programs for over three years now, but I’ve never actually been for¬ 
mally trained, so I’d like to make sure I have my facts straight 
before teaching them to others. 

Thanks for any help you can provide. 

Sorry, I can be of no help there. I personally don’t believe object- 
oriented design is terribly distinct from design, and I don’t feel 
design can be taught (but I do believe it can be learned). I probably 
represent a minority viewpoint on that subject, however, and you 
should be able to get good recommendations by posting on the 
appropriate CompuServe or Usenet forums. —rib 


Books Received 


Axelson. Parallel Port Complete. Lakeview Research. 343 pages 
(includes disk). $39.95. ISBN 0-9650819-1-5. Out of nowhere, 
here comes a self-published, focused book that delivers what it 
promises: detailed technical information on the parallel port. 
Includes circuits you can build, and many code examples in VB. 
Check out the Web site at www .lvr.com. 

Buck-Emden and Galimow. SAP RJ3 System: A Client/Server 
Technology. Addison-Wesley Developers Press. 248 pages. 
$29.95. ISBN 0-201-40350-1. The English version of a German 
book that provides technology descriptions of client/server and 
how to implement it with SAP’s software. 

Coombs, Coombs, and Brewer. ActiveX Sourcebook: Build an 
ActiveX-Based Web Site. Wiley. 400 pages. $29.95. ISBN 
0-471-16714-2. High-level descriptions of the Web, a very light 
introduction to ActiveX scripting, and enough white space to 
drive a truck through. 

Davis. Win32 Network Programming. Addison-Wesley Developers 
Press. 832 pages. $44.95. ISBN 0-201-48930-9. As the subtitle 
says, “Windows 95 and Windows NT Network Programming 
Using MFC.” Mostly NT. 

Fahey. Web Publisher’s 3D & Animation Design Guide for 
Macintosh. Coriolis Group. 464 pages. $39.99 (includes 
CD-ROM). ISBN 1-883577-94-2. 

Feinberg, Keene, Mathews, and Withington. Dylan Programming: 
An Object-Oriented and Dynamic Language. Addison-Wesley. 
412 pages. $29.00. ISBN 0-201-47976-1. An introduction to 
Apple’s language-that-is-not-Java. 

Heller. Who’s Afraid of C++?. AP Professional. 480 pages. $39.95 
(includes CD-ROM). ISBN 0-12-339097-4. Go from knowing 
nothing to knowing C++ in 480 pages. 

Koenig and Moo. Ruminations on C++. Addison-Wesley. 380 
pages. $29.00. ISBN 0-201-42339-1. Based on Koenig’s 
columns in the Journal of Object-Oriented Programming 
(JOOP), C++ Journal, and C++ Report, but extended and 
revised. 


Lippman. C++ Gems. SIGS Books. 601 pages. ISBN 1-884842-37-2. 
A collection of articles that originally appeared in the C+ + Report. 

Messmer. The Indispensable Pentium Book. Addison-Wesley. 496 
pages. $29.95. ISBN 0-201-87727-9. A detailed look at the hard¬ 
ware architecture of the Pentium. 

Pappas and Murray. Java with Borland C++. AP Professional. 428 
pages. $34.95. ISBN 0-12-511960-7. An introduction to Java, 
using the Borland C++ Add-On for Java. 

Shalit. The Dylan Reference Manual. Addison-Wesley. 469 
pages. $37.61. ISBN 0-201-44211-6. The “definitive refer¬ 
ence manual,” also supposedly available on the Web at 
www.cambridge.apple.com, though I was unable to load that 
page. 

Shampine, Allen, and Pruess. Fundamentals of Numeric 
Computing. 268 pages. $72.95. ISBN 0-471-16363-5. An acade¬ 
mic textbook — all math, no code. 

Siegel. Object Oriented Software Testing: A Hierarchical Approach. 
511 pages. ISBN 0-471-13749-9. “You read this book different¬ 
ly than you read other technical books. This book is a system.” 
Coming soon, a book to teach you how to read the book! 

Sutton. Windows NT Security Guide. Addison-Wesley Developers 
Press. 400 pages. $29.95. ISBN 0-201-41969-6. Really for 
sysadmins concerned with security, but it’s also easier to under¬ 
stand the NT security API if you know how people use it. □ 
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Send your press release to Miller Freeman, Inc., 1601 W. 23rd St. 
Suite 200, Lawrence, KS 66046; fax 913-841-2624; 
wdletter@mfi. com. 

Genitor Corporation Ships the Genitor 
Development Tools Suite 

Genitor Corporation has released GENITOR, a suite of devel¬ 
opment tools that helps C/C++ developers to implement and 
reuse objects. GENITOR stores object information in one or 
more sharable databases. Using search and browse capabilities, 
programmers can locate and reuse objects developed by any 
member of their project team. Users can generate printed or 
online documentation describing a single or collection of objects 
by clicking the appropriate toolbar button. GENITOR supports 
production turnover procedures and integrates to several popular 
version control systems. 

GENITOR automates many coding tasks that are normally done 
by hand. Users can control formatting, style, and commenting rules 
that affect the look of generated files. GENITOR can automatically 
embed trade secret, copyright, or other notices in generated code 
and documentation. The current version of GENITOR runs on 
Windows 95 and Windows NT 4.0. 

GENITOR is available in single- and multi-user configurations. 
Prices start at $495. For more information, contact Genitor 
Corporation, 210 Collingwood Dr., Ste. 200, Ann Arbor, MI 
48103; 888-436-4867 or 313-213-2500; fax 313-213-2525; 
info@genitor.com; www.genitor.com. 

Antares Launches Edge 

Antares Alliance Group has released Edge, an object-oriented 
Web development and execution framework based on Microsoft’s 
Visual Basic for Applications (VBA). Edge provides developers 
with a self-contained development and execution environment for 
delivery of highly interactive Web solutions on Windows 95, NT 
4.0 Workstation, and NT 4.0 Server platforms. 

Microsoft’s VBA is integrated directly into Edge’s development 
and execution environments. Events written in other languages 
such as C++ and Java can be integrated through external event 
mapping. External data access is provided to ODBC databases, the 
Microsoft Jet database engine and OLE-compliant data providers 
via ActiveX data objects. 

For a single execution engine/single development machine, the 
Personal Edition Edge Developer Kit is priced at $299. The Edge 
Workgroup Series starts at $995. For more information, contact 
Antares Alliance Group at 800-726-7287 or 408-370-7287; 
fax 408-370-7649; sales@antares.com; www.antares.com. 

Hyper Act Releases HyperTerp v4.0 

HyperAct, Inc. has released version 4.0 of HyperTerp. New 
features include plug-in architecture, constructor and destructor 
definitions for object types, object-based syntax support, and 
improved speed. 

HyperTerp features a true Delphi VCL; supports user forms. 


procedures and functions; debugger interface; arrays, tables, and 
objects; drag-and-drop on a form; I/O and error events that sim¬ 
plify the integration with an application user interface; and regis¬ 
tration and extension events to add custom functionality to 
HyperTerp. 

HyperTerp v4.0/STD costs $249. HyperTerp/PRO costs $395 
including source code. HyperTerp is 100 percent electronic, no 
printed material, available for FTP download (no S&H). 

For more information, contact HyperAct Inc., 3437 335th St., 
West Des Moines, IA 50266; 515-987-2910; fax 515-987-2909; 
76350.333; rhalevi@hyperact.com; www.hyperact.com. 

Inventions Ships the ILIB3 Neural Imaging 
Library 

Inventions’ neural imaging library (ILIB3) offers the potential 
to integrate neural networks with pattern recognition techniques, 
making neural imaging systems faster and more efficient. 

Neural networks work on problems where a set of correct 
solutions is available, such as learning to recognize tumors by 
examining x-rays with known benign or malignant areas. A neur¬ 
al network is trained by presenting it with a set of images with 
known results; for example, a scene with or without intruders for 
a security system. After training, new images can be classified 
with a high degree of accuracy. 

Pre-processing the data with pattern recognition algorithms 
makes training more effective by eliminating redundant input data. 

ILIB3 is compatible with Inventions’ image processing and 
image analysis libraries (ILIB1 and 2), and is used with Visual 
Basic, Visual C++, or other 32-bit compilers. 

For more information, contact Inventions, 
tel/fax +44 (0) 161-973-3047; ilib@inventions.u-net.com. 

StormX Software Releases SX Tracker 

StormX Software has released SX Tracker, a defect and change- 
request tracking system that allows software developers to manage 
and resolve problems and change-requests that threaten software 
quality. 

The SX Tracker system setup is much simpler than that for 
client/server-based applications. Many of the values are user-defin¬ 
able so that SX Tracker can be customized to fit the user’s software 
development process. SX Tracker automatically keeps a history of 
the work that’s been done. All documents created during the devel¬ 
opment process can also be directly attached to the defect record. 

SX Tracker can automatically notify users of changes made to 
the defect record. Users can be notified via internal notification 
engine, cc:Mail(VIM), MSMail(MAPI), Internet email, or any 
combination of those. SX Tracker allows system administrators to 
define different security levels for each user. 

SX Tracker costs $199 per license. For more information, con¬ 
tact StormX Software, Inc., 7914 W. Dodge Rd. #434, Omaha, NE 
68114; 402-553-6671; fax 402-551-7699; info@stormx.com; 
www.stormx.com. 
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SYWARE Announces Dr. DeeBee ODBC Driver 
for Windows CE 

SYWARE, Inc. has released the Dr. DeeBee ODBC Driver for 
the Windows CE operating system platform. The new ODBC driver 
allows Windows CE-based handheld computers to act as dataservers 
to desktop applications, connecting them to such software such as 
Microsoft Access, Microsoft Excel, the Visual Basic programming 
system, Powerbuilder, and Crystal Reports. The ODBC 2.1-compli¬ 
ant driver is Windows 3.x-resident, thereby consuming none of the 
handheld’s memory space. Prices vary by volume. 

For more information, contact SYWARE, Inc., P.O. Box 91 
Kendall, Cambridge, MA 02142; 617-497-1376; fax 617-497-8729; 
frank@syware.com; www.syware.com. 

Wilson WindowWare Offers Batch Language 
Packages 

Wilson WindowWare’s two new products, WinBatch 96g and 
WebBatch, provide cross-platform scripting for standard networks 
and servers. The WinBatch 96g is a complete programming lan¬ 
guage for automating PC operations, with enhancements for 
Internet support, generic network functions, and a help system. It 
includes 32-bit software for Windows NT and Windows 95, and 
16-bit software for Windows 3.1, to automate and control every 
routine Windows operation or chore, on individual Windows PCs 
or across networks. Wilson WindowWare also provides the 
WinBatch 96 with a compiler. The WinBatch+Compiler Package 
creates royalty-free executables for distribution. 

The WebBatch 96 is a dynamically executed CGI scripting lan¬ 
guage that runs on Windows NT-based Web servers, and will sup¬ 
port the Microsoft Windows 95 Personal Web Server. It provides 
sophisticated techniques such as late-binding dynamic runtime vari¬ 
able substitution, process management, and recursive execution. 

WinBatch costs $99.95 for a single user. The WinBatch/Server 
package costs $995 per server. The WinBatch+Compiler pack¬ 
age costs $495. WebBatch costs $295. For more information, 
contact Wilson WindowWare, 2701 California Ave. SW, Ste. 
212, Seattle, WA 98116; 206-938-1740; fax 206-935-7129; 
morriew@windowware.com; www.windowware.com. 

Evergreen Announces EasyER vl.2 

Evergreen Software Tools, Inc. has released EasyER version 
1.2. an upgrade of the company’s modeling/database design 
tool. EasyER supports the design and implementation of desk¬ 
top and client/server databases using entity-relationship dia¬ 
grams (ERDs) and class diagrams (for object-oriented methods) 
to graphically describe database tables, field structures, primary 
keys, indexes, foreign keys, relationships, cardinality, referen¬ 
tial integrity constraints, domains (user-defined types), triggers, 
and stored procedures. EasyER supports data modeling using a 
number of methodologies. 

The optional Visual Basic interface (EasyER/VB) lets users 
generate VB4 projects and forms directly from their EasyER data 
model. These forms act as the user interface to the underlying data¬ 
base tables, which can be created using EasyER’s database schema 
generation functionality. 

The EasyER upgrade is available for a nominal charge to regis¬ 
tered EasyER vl.Ox or 1.1 users and can be downloaded from their 
Web site. For more information, contact Evergreen Software 
Tools, Inc., 15444 NE 95th St., Ste. 244, Redmond, WA 98052; 
800-929-5194 or 206-881-5149; fax 206-883-7676; 
marketing@esti.com; 75303,1346; www.esti.com. 


Blinkinc Announces Shrinker 2.1 

Blinkmc has released Shrinker 2.1, a compression and archiv¬ 
ing product that compresses 16-bit Windows and real-mode DOS 
programs, and executes these programs indirectly with no separate 
decompression step. 

Compatible with programs created by many 16-bit Windows or 
DOS compilers, including Delphi and C++, Shrinker 2.1 can also 
create directly executable compressed Visual Basic programs. 

By reducing the amount of data actually transmitted and 
decompressing the program on the local workstation at runtime, 
Shrinker minimizes local and wide area network traffic to opti¬ 
mize network performance. Unlike disk compression utilities that 
compress all the data stored on the disk, Shrinker’s selective com¬ 
pression at the individual file level means there is no risk of data 
loss. Shrinker’s compression encrypts computer software to act as 
an effective protection against decompilers. 

Shrinker 2.1 costs $149. There are no runtime royalties. For 
more information, contact Blinkinc, 8001 West Broad St., 
Richmond, VA 23294; 804-747-6700; fax 804-747-4200; 
www.blinkinc.com. 

On-Line Innovations Introduces Open Dialog 

On-Line Innovations has released Open Dialog, a developer’s 
toolkit for graphical interactive online applications. Users run 
Open Dialog applications using a small client program that acts as 
an agent for the actual application, which runs on a server comput¬ 
er. The net effect is that the application looks like it is running on 
the user’s machine, while it is really running on a server. Open 
Dialog recognizes code written in any language capable of making 
DLL calls. The toolkit contains the API, sample programs, a manu¬ 
al, and a license for five concurrent users. 

The initial cost for Open Dialog is $695. For more informa¬ 
tion. contact On-Line Innovations, One East Erie, Chicago, IL 
60611; 800-933-6491 or 312-337-7800; fax 312-337-1677; 
sales@atgsystems.com; www.atgsystems.com. 

Proforma Announces Provision Workbench r2 

Proforma has announced release 2 of Provision Workbench 
(PVW), its business process and object modeling tool. Provision 
Workbench r2 integrates business process and business object 
analysis with systems development. It gives business and IT spe¬ 
cialists a common environment to (re)define, model, and automate 
business processes and reusable business objects. PVW includes 13 
modelers with customizable methodology support, text inter¬ 
preters, spelling and completeness checkers, and a Web-based 
communication facility. PVW translates business objects into code 
for VisualAge/Smalltalk, PowerBuilder, Visual Basic, VisualWorks, 
GemStone/Smalltalk, C/C++, and SQL schema. 

PVW supports the leading BPR. object-oriented, and structured 
methodologies including Rummler-Brache. Booch, OMT, Use 
Case, and Unified 0.8. In addition, PVW has methodology cus¬ 
tomization and model annotation capabilities, so methodologies can 
evolve to meet corporate standards and new industry innovations. 

PVW costs $1,695 for a single-user license; application 
development interfaces are $595 each. For more information, con¬ 
tact Proforma, 17515 W. Nine Mile Rd., Ste. 1170, Southfield, MI 
48075; 800-743-1557 or 810-443-0055; fax 810-443-0070. 

Segue Launches QA Performer 

Segue Software. Inc. has introduced QA Performer, a multi¬ 
platform load testing tool designed to predict the reliability and 
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performance of client/server applications before they deploy. It 
provides organizations with the ability to create load and perfor¬ 
mance tests for use during the design, implementation, operation, 
and maintenance of client/server applications. 

QA Performer features include the ability to predict perfor¬ 
mance early in the design cycle by allowing developers to proto¬ 
type transactions, unlimited user simulations, a wizard to step 
users through a point-and-click process that automatically gener¬ 
ates and runs a load test, automatic data creation to generate real¬ 
istic test data to populate databases automatically, and graphical 
reporting capability. 

QA Performer is priced according to the number of simulated 
users and starts at $10,000. For more information, contact Segue 
Software, Inc., 1320 Centre St., Newton Centre, MA 02159; 
800-287-1329 or 617-796-1000; fax 617-796-1610; 
info@segue.com; www.segue.com. 

Netquake Releases Joltz 

Netquake, Inc. has released its Joltz controls, a collection of 
reusable graphical user interface (GUI) widgets and interactive, 
multimedia controls for Java applets and applications. 

The Joltz package includes controls and panels for GUI and 
multimedia/special effects. The GUI controls include Tree View 
Panel, Multi-Column List Panel, Tabbed Panel, Wizard Panel, 
Splitter Panel, Scroll Panel, Color Chooser Control, Slider 
Control, Image Buttons, Progress Meter, 3D Separator, 3D 
Border Panel, and Group Panel (3D Etched). Multimedia/Special 
Effects controls include Interactive Image with HotSpots, Image 
Fader, and Banner. 

Joltz costs $149. For more information, contact Netquake, 
Inc., 6118 Blue Ridge Dr. #D, Highlands Ranch, CO 80126; 
fax 801-282-0528; joltz@netquake.com; www.netquake.com. 

MicroHelp Ships Muscle32 

MicroHelp, Inc. has shipped a new version of Muscle32. 
Muscle32 functionality includes array sorting, advanced string 
manipulation, extensive file and directory services, and system 
information. The over 250 routines in Muscle32 are faster than the 
equivalent Visual Basic code and perform many tasks that cannot 
be done in native Visual Basic code. All the routines in the 
Muscle32 DLL are written in 32-bit assembler for maximum per¬ 
formance. Most routines are simple one-line calls that can replace 
hundreds of lines of Visual Basic code. 

Muscle32 is designed to be compatible with 32-bit versions of 
Microsoft Visual Basic, Visual C++, and any other languages that 
support 32-bit DLL calls. 

Muscle32 costs $199 with an introductory price of $169. 
Upgrades from Muscle 2.0 are $99. Muscle32 Assembler source is 
available separately for $149. For more information, contact 
MicroHelp, Inc., 4211 J. V.L. Industrial Park Dr., NE, Marietta, GA 
30066; 770-516-0899; fax 770-516-1099; www.microhelp.com. 

Opus Software Releases Opus Make v6.1 

Opus Software has announced the release of Opus Make ver¬ 
sion 6.1. New features include: added support for Microsoft Visual 
SourceSafe v5.x and MKS Source Integrity, improved integration 
to Microsoft Visual C++, Borland C++, and GNU RCS, improved 
emulation for Microsoft Nmake and InterSolv Configuration 
Builder, support for MS-DOS, OS/2, WinNT, Win95, AIX, SCO, 
HP/UX, UNIX, SunOS, Solaris, and IRIX. 

Opus Make offers features such as pattern-based inference 
rules, support for multiple directories, unsurpassed macro support. 
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makefile debugging, object library support, conditional and loop¬ 
ing constructs. Opus MKMF (MaKeMakeFile) automatically 
updates makefiles and macros by scanning your source files for 
header files and thus determining dependencies. 

Opus Make v6.1 starts at $165. Upgrades start at $69. 

Discounts for multiple licenses are available. For more informa¬ 
tion, contact Opus Software, 1032 Irving St., Ste. 439, San 
Francisco, CA 94122; 415-485-9703; fax 415-485-9704; 
biz@opussoftware.com; www.opussoftware.com. 

DataViews Launches DV-XPresso 2.0 

Data Views Corporation has announced DV-Xpresso 2.0, a 
realtime graphics package that allows developers to create and 
customize cross-platform 2-D and 3-D dynamic data displays for 
decision support, enabling users to make rapid decisions based on 
time-sensitive data. Dynamic graphics are built with DV-Xpresso 
and deployed to the Web, Windows, or UNIX, always retaining 
the native look and feel of their respective platform. DV-Xpresso 
2.0 also provides improved performance of realtime graphics. 
Developers can use DV-Xpresso to control, monitor, and repre¬ 
sent data for executive information systems in industrial and 
financial applications. 

DV-Xpresso’s package of 120+ standard charts and graphics 
provides developers with a resource-based graphics model. By 
supporting both realtime data sources and relational databases, 
DV-Xpresso provides users with visual representations of dynam¬ 
ic data. DV-Xpresso 2.0 also allows developers to create custom 
decision support graphics using the DV-Xpresso Application 
Builder’s new point-and-click editor. 

Prices for DV-XPresso start at $1,000. For more information, 
contact DataViews Corporation, 47 Pleasant St., Northampton, 
MA 01060; 413-586-4144; fax 413-586-3805; info@dvcorp.com; 
www.dvcorp.com. 

Logic Programming Announces Pro Web 
Server 

Logic Programming Associates has announced the availability 
of the LPA Pro Web Server. The LPA Pro Web Server supports the 
development, testing, and deployment of intelligent, interactive, 
non-deterministic applications across the Web. The LPA ProWeb 
Server hides the complexity of HTML forms and CGI program¬ 
ming, and by handling all the communication between the forms 
and the application logic, relieves the developer all the irksome 
bookkeeping. Forms can be defined either using a familiar HTML 
editor, or for complex, dynamic tasks, in Pro Web’s sophisticated 
pseudo-language. 

Features of the LPA ProWeb Server include: transparent gen¬ 
eration of WWW Interface (automatic creation of associated 
HTML and CGI code), control over granularity of conversations 
(number of forms/questions to be answered in each exchange), 
session management (ProWeb maintains session continuity for 
multiple asynchronous users), and support for backtracking 
through alternative solutions (exploiting Prolog’s non-determinis¬ 
tic nature). 

ProWeb Server costs $495 for the Programmer Edition and 
$995 for the Developer Edition. For more information, contact 
Logic Programming Associates Ltd., Studio 4, R.V.P.B., Trinity 
Road, London SW18 3SX, UK; in the US, 800-949-7567; 
44-181-871-2016; fax 44-181-874-0449; 
lpa@cix.compulink.co.uk; www.lpa.co.uk. 
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Blinkinc’s NOVLIB 3.1 Supports Both 16- and 
32-Bit 

Blink/nc has released NOVLIB 3.1, a 16- and 32-bit network 
library that integrates support for Visual Basic. Delphi. C/C++, 
CA-VO, and CA-Clipper into a single product. Version 3.1 intro¬ 
duces 32-bit support for NetWare-aware programs on a Windows 
95 client, plus 16-bit support for Windows, DOS-extended, and 
real-mode DOS applications for Novell networks. 

NOVLIB 3.1 features over 450 network functions for printing, 
security, mapping, messaging, accounting, etc. NOVLIB 3.1 is dis¬ 
tributed as both a DLL and a LIB file and features a comprehensive 
Windows help file. 

NOVLIB 3.1 costs $299 with no runtime royalties. For more 
information, contact Blinkinc, 8001 West Broad St., Richmond, 

VA 23294; 804-747-6700; fax 804-747-4200; www.blinkinc.com. 

Liant Ships Relativity for MVS 

Liant Software Corporation has shipped Relativity for MVS. 
Relativity enables MIS organizations to deliver easy access to 
enterprise data locked in VS AM files without making any 
changes to legacy code or data. Data access problems are solved 
as MVS VSAM data is mapped into a full-featured relational data 
source that can be accessed directly from over 300 Windows 
desktop tools. Relativity makes it possible for developers to 
extend the life of existing systems by integrating them into new 
client/server applications using Visual Basic, PowerBuilder, or 
other development tools — without the inefficiencies of data 
warehousing, replication, or costly data conversions. 

Relativity is 100 percent compliant with Microsoft’s ODBC 
standard, enabling users to transparently combine COBOL-main¬ 
tained VSAM data with relational data and 16- or 32-bit Windows 
applications such as Access, Word, Lotus 1-2-3, PowerBuilder, and 
Crystal Reports. 

Relativity for MVS pricing begins at $37,000. For more infor¬ 
mation, contact Liant Software Corporation, 800-349-9222 or 
512-371-7028; fax 512-371-7609; relativity@liant.com; 
www.liant.com. 

BlueWater and AMCC Release PCI Reference 
Drivers for NT 

BlueWater Systems and Applied Micro Circuits Corp. have 
released Windows NT Reference Drivers for the AMCC S5933, a 
PCI interface chip. The PCI Reference Drivers support the AMCC 
Matchmaker Development Kit for the S5933 chipsets. Source code 
for the PCI Reference Drivers is available on request directly form 
BlueWater Systems, or BlueWater Systems’ Web site. The PCI 
Reference Drivers provide samples for controlling the 
AMCCS5933 interface chip. 

The BlueWater Systems/AMCC PCI Reference Drivers are 
based on BlueWater Systems’ WinDK Class Library and the 
WinDK Device Driver Development Kit. The PCI Reference 
Drivers are intended to be used as a template for commercial NT 
drivers and expanded upon using WinDK. 

The full PCI Reference Drivers are available at no charge. The 
full WinDK Device Driver Development Kit for NT 4.0 and 3.51 
costs $795. For more information, contact Bluewater Systems Inc., 
190 West Dayton; P.O. Box 776; Edmonds, WA 98020-0776; 
206-771-3610; 800-962-2114; fax 206-771-2742; 
info@bluewatersystems.com; www.bluewatersystems.com. 


Pick Systems Introduces D3 DBMS for NT, 95 

Pick Systems, Inc. has announced availability of their D3 
DBMS for Windows NT and Windows 95. D3 offers the security of 
compatibility with existing Pick, Picklike, and relational (SQL) 
applications code, plus a suite of capabilities to support migration 
to n-tier client/server, Internet- and intranet-enabled, data ware¬ 
house, distributed domain, and GUI-charged architectures. 

A set of Visual BASIC objects and OCX that ship with D3, com¬ 
bined with integrated development environment extensions, facili¬ 
tate development of distributed client/server applications. D3 
includes a scaleable, high-performance, generalized database server. 

Retail pricing for the single-user Windows 95 version is $200. 
D3 NT is priced at $1,000 for the primary domain server under NT 
Server and one client or $325 per primary domain server (and first 
client) under NT Client, and $300 per additional client. 

For further information, contact Pick Systems, 1691 Browning, 
Irvine, CA; 800-367-7425 or 714-260-5151; fax 714-250-8187; 
denis@picksys.com; www.picksys.com. 

Rogue Wave Ships lnter.Net.h++ vl.O C++ 
Class Library 

Rogue Wave Software. Inc. has announced Inter.Net.h++ vl.O, 
a C++ class library that provides C++ classes for many Internet 
communications, including FTP, HTTP, SMTP, and POP3. All 
classes are portable between major Windows and UNIX platforms. 

Inter.Net.h++ uses a two-layered architecture. The Agent layer 
provides classes at a higher level of abstraction that perform com¬ 
plete protocol transactions. With the Agent classes, developers can 
add complete protocol functionality with just a few lines of code. 
The classes in the Client layer give developers fine-grained control 
of details of the protocol, allowing them to build custom, specific 
solutions. 

Inter.Net.h++ uses Rogue Wave’s Threads.h++ library in a manner 
that is transparent to the developer. This makes it possible for develop¬ 
ers to add multithread-hot capabilities to their C++ Internet applica¬ 
tions without mastering the intricacies of multithreaded programming. 

Inter.Net.h++ costs $495 for a single-user license; annual sup¬ 
port contracts are $245. For more information, contact Rogue Wave 
Software, 260 .5IT Madison Ave. P.O. Box 2328, Corvallis, OR 
97339; 800-487-3217 or 503-754-3010; fax 503-757-6650; 
www.roguewave.com. 

IBM Offers TeamConnection v2 

IBM has announced TeamConnection v2, a collaborative, LAN- 
based. client/server development environment that helps teams of 
programmers to control joint development projects. TeamConnection 
v2 now includes platform support for Windows NT and UNIX. 

TeamConnection v2 new server platforms include Windows NT. 
ADC, and HP-UX. New client platforms are AIX and HP-UX. 
Version 2 will also include support for AIX, Windows 95, and 
HP-UX build platforms. 

TeamConnection v2 includes a Tool Builders Development Kit 
that includes a documented object-oriented model, documented 
application programming interfaces, and a graphical interface for 
extending the information model. Version 2 also includes extended 
support for the MVS development environment. 

TeamConnection v2 costs $995 for a registered client or $2,495 
for a concurrent client. The server is priced at $9,995 for Intel 
servers or $19,995 for UNIX servers. For more information, con¬ 
tact IBM Software Group, Route 100, Somers, NY 10589; 
askibm@info.ibm.com; www.software.ibm.com. 
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Micro Edge Announces Delphi v2.0 Integration 
for Visual SlickEdit v2.0 

MicroEdge, Inc. has announced the availability of Delphi v2.0 
integration for Visual SlickEdit v2.0. Visual SlickEdit is a graphi¬ 
cal. cross-platform text editor. MicroEdge has created an environ¬ 
ment where users can edit Delphi source code while using the fea¬ 
tures of Visual SlickEdit. 

When a user opens Visual SlickEdit from within Delphi, the 
source code appears automatically in Visual SlickEdit. with the 
cursor in the exact location as it appears in Delphi. From that 
point, all editing done from within Visual SlickEdit is instantly 
updated in Delphi. The two products behave as one. When the 
user closes a project or file in Delphi, the corresponding file is 
automatically closed in Visual SlickEdit. The same holds true 
when the user closes a file from within Visual SlickEdit — 

Delphi will also close the file. 

Delphi v2.0 integration is available free of charge for all Visual 
SlickEdit v2.0 users. For more information, contact MicroEdge, 

Inc., P.O. Box 18038, Raleigh, NC 27619; 800-934-3348 or 
919-303-7400; fax 919-303-8400; sales@slickedit.com; 
www.slickedit.com. 

Stingray’s Objective Blend Provides Object- 
Oriented Grid Extension for Java 

Stingray Software Inc. has shipped its first Java class library. 
Objective Blend 1.0 for Java. The library contains full source code 
and provides more than ten graphical Java classes. To ease the way 
for developers who use Symantec Cafe and Microsoft’s Visual J++ 
Java, Objective Blend includes samples and project files for both of 
these development environments. Objective Blend 1.0 extends and 
enhances Sun’s Abstract Windowing Library and provides a collec¬ 
tion of components with full Java source code. 

The Objective Blend library provides a wide variety of classes. 
The Tree control lets data be simply represented in a hierarchy. 

Tree levels can be customized with bitmaps representing expanded 
and unexpanded states. Program developers can also specify that 
levels be drawn with a traditional boxed plus or minus sign to indi¬ 
cate whether or not a level has been completely expanded. Levels 
can be easily dragged and dropped to other places in the tree, and. 
similarly, entire levels (with all subchildren) can be moved or 
duplicated to any position in the tree. 

Objective Blend costs $295, which includes full source code 
and 60 days of technical support. For more information, contact 
Stingray Software Inc., 800-924-4223 or 919-461-0672; 
fax 919-461-9811; sales@stingsoft.com; www.stingsoft.com. 

Burton Systems Ships TUB Version Control 
for Windows 

Burton Systems Software has shipped the Windows version of 
its TLIB Version Control system. TLIB for Windows is part of the 
combo edition of TLIB Version Control 5.04, which also includes 
command-line versions of TLIB for DOS, OS/2, and Windows NT. 

TLIB for Windows features a GUI, with file picklist, button bar. 
menus, right-button functionality, status-bar guidance. MRUs, etc. 
It is fully compatible with command-line versions of TLIB, and 
upward-compatible with all past versions of TLIB. 

TLIB now integrates with several IDEs, and directly supports 
compiler-native project files for several software development 
tools, including Visual Basic 3.0 and 4.0, Watcom C/C++ 10.x, and 
Help Magician Pro. 

TLIB has over 100 configuration options to customize its oper¬ 


ation, and its configuration facility supports both conditional load¬ 
ing and compound expression evaluation. 

TLIB combo edition costs $225 (5-pack $925). TLIB for DOS 
costs $139 (5-pack $539). Upgrades start at $30. For more infor¬ 
mation. contact Burton Systems Software, P.O. Box 4157, Cary, 
NC 27519-4157; tlibinfo@burtonsys.com; www.burtonsys.com. 

Software Productivity Research Debuts SPR 
KnowledgePLAN 

Software Productivity Research (SPR) has introduced SPR 
KnowledgePLAN, a tool for software estimation. 

KnowledgePLAN is capable of planning new, enhancement, or 
maintenance software projects including effort, schedule, depen¬ 
dencies, resource requirements, and defect predictions. 

KnowledgePLAN guides users through the development of a 
project estimate with a Project Wizard, using simple “sizing by 
analogy” as an alternative to more complicated metrics. The pro¬ 
gram, native to Windows 95 and Windows NT, includes online 
help, extensive customization capabilities, and access to many cor¬ 
porate databases, report writers, and analysis tools. 

KnowledgePLAN provides a proven estimation methodology 
and an extensive knowledge base of over 6,700 projects represent¬ 
ing all major software environments. Updated annually, the knowl¬ 
edge base incorporates adjustment factors on personnel, process, 
technology, and environment that have the most impact on project 
performance. 

SPR KnowledgePLAN costs $2,900 to $5,900, depending on 
quantity. For more information, contact Software Productivity 
Research, One New England Executive Park, Burlington, MA 
01803-5005; 617-273-0140; fax 617-273-5176; sales@spr.com; 
www.spr.com. 

Data Junction Announces Cambio for 
Windows 

Data Junction Corporation has announced Cambio for 
Windows, a software tool that automatically captures useful fields 
of data from complex, irregular text files and reports, and builds 
those fields into clean database records. In addition to standalone 
usage, Cambio also can be integrated as a front end to the compa¬ 
ny’s universal data conversion product, Data Junction for 
Windows. 

Cambio processes text data from a variety of sources, including 
print files, screen dumps, Internet text downloads, email messages, 
tagged ASCII files, OCR output, multiline ASCII or EBCDIC 
records, mailing labels, data publishers such as DIALOG and 
LEMS, online text and news services such as Reuters, and CD-ROM 
textbases. 

Cambio for Windows costs $ 199. For more information, contact 
Data Junction Corporation, 2200 Northland Drive, Austin, TX 
78756; 800-580-4411 or 512-459-1308; fax 512-459-1309; 
info@datajunction.com, www.datajunction.com. 
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Send letters to wdletter@mfi.eom. 


From: bosela@tol.tcel.com (Brian Bosela) 

Subject: To the editor: Wrong,wrong wrong. 

Is your brain stuck in a compute bound process? I’m sure Jim 
Seymour’s is not. 

That’s a rhetorical question, right? —rib 


Subject: threads 
Ron. 

I’m glad to see in January 1997 Windows Developer’s Journal 
you took a position against threads. Threads are a kitchen-sink men¬ 
tality of programming (we have a feature, let’s use it). After years of 
writing interrupt handlers (and now using Posix Pthreads), I shy 
away from threads unless the application will really benefit from 
them. It’s much better to find a good, single-threaded solution than 
to start throwing threads at a problem. 

marty leisner@sdsp.mc.xerox.com 
“Don’t confuse education with schooling.” — Milton Friedman to 
Yogi Berra. 

There are certainly problems for which threads are an elegant 
and efficient solution. However, threads are not a magic pill that 
speeds up applications, which is the sort of characterization I was 
railing against. You're right — there’s a kind of programming dis¬ 
ease that makes us search for a way to use any new feature without 
spending too much time figuring the actual benefits. —rib 


Ron, 

I tried to invoke mstater to install the SDK annotations (VC++ 
v4.1) and keep getting: “Open the infoviewer window in Developer 
Studio before running MsTater” but Developer Studio is running 
and the Info Viewer window is already open. 

Any suggestions? 

Wayne 

At long last, I got a few free hours to invest in the automatic 
annotation software. I revised that error message to include the 
more helpful text (“make sure the infoviewer window is maxi¬ 
mized”). If you just maximize the infoviewer window, it should 
work. I also took a stab at fixing mstater.exe so it works with 
Visual C++ v4.2. Read the notes at the beginning of sdkann.txt 
(which resides in sdkann.zip, which is available at www.wdj .com) 
to see what the current state of affairs is. —rib 


From: Tim Kohler 
<tkohler@eisc.org> 

Subject: parallel port programming in Win32 (previous article) 
Dear Ron: 

I am currently pursuing information on parallel port program¬ 
ming. While monitoring the newsgroups, I have come across a ref¬ 


erence to an article you published in the February 1996 Windows 
Developer’s Journal entitled “Bypassing Win95 Printer Device 
Drivers.” Since the online journal only goes back to March, I have 
had some difficulty obtaining a copy of the article. I was wondering 
if this might be available from another site or via email. 

Pretty much all of our code disks for back issues (including the 
one you ’re looking for) are on our Web site, but the confusion is 
understandable. Like a lot of Web sites, our home page undergoes 
constant tinkering. That’s not necessarily bad, but it can make it 
hard to document in the magazine how to find something online. In 
fact, after reading your email I went to our Web page and had a 
good bit of trouble myself locating the link to our source archives. 
There is now a more obvious and visible link on the home page that 
takes you to the complete source code archives; the page that con¬ 
tains the complete index to downloadable code is 
WWW . wd j . com/source. htm. Also, we have begun printing that link in 
our articles, just to make it easier to remember and find. 

We don’t upload the text of most of the magazine articles to the Web 
site, but you can also purchase copies of old articles or back issues via 
WWW.wdj.com or by sending email to orders@mfi .com. If you find 
yourself buying more than a couple, then the WDJ CD-ROM might be 
a more economical choice (also sold through the Web site). —rib 


Subject: Annotations 
Hi, 

I have a couple of questions regarding annotations: I want to 
contribute my annotation to WDJ, but my annotation is DDK-relat¬ 
ed and is not found in any help file. How can I do it? I do not see any 
place where the contributer’s name gets displayed. Is it a common 
method or is it on request? 

Thanks 

Mukesh R. Bhakta 
Anvika Technologies 
mukesh_bhakta@bigfoot.com 

The DDK is certainly worthy of annotating, but we don't cur¬ 
rently take DDK annotations — I just don’t have the expertise to 
assess annotations in that area. I believe Walter Oney started such 
an annotation list when he wrote his VxD book (Systems 
Programming for Windows 95) for Microsoft Press. You might want 
to poke around the Web or look in his book for more information. 

In general, we credit the person who submitted the annotation at 
the bottom of each annotation (take a look at sdkann.txt for exam¬ 
ples). When you see an annotation for which no one is credited, then 
it probably either came from me or from V. Ramachandran, who 
handles most of the work of verifying and editing the annotations. I 
think I recently threw a batch of my own annotations in, so it may 
have appeared that we had stopped crediting people. —rib 


From: TMFZ63A@prodigy.com (Robert Walkiewicz) 

Subject: Disabling Warm Boots 

I have been trying to intercept the three-key warm boot and dis¬ 
able it from a 16-bit program running in Windows 95 and have 
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determined that it can’t be done from a keyhook DLL. I can disable 
the entire keyboard, but when the three dreaded keys are pressed, it 
still gives you the Close Program Dialog. I see that Microsoft has 
done this for their screen savers; Norton has also accomplished this 
feat (For Your Eyes Only). Is there a way to do this or possibly inter¬ 
cept the Close Dialog Box to do this for you? 

My best guess would be that a 16-bit program running under 
Win95 would need the help of a VxD to disable Ctrl-Alt-Del. Does 
anyone know of an alternative that does not require a VxD? —rib 


From: <RedDrgnEye@aol.com> 

Subject: Editor 

Hello. I am a Visual Basic programmer. I have purchased sev¬ 
eral books that say to get on mailing lists through CompuServe. 
But I do not have CompuServe. I was wondering if you can maybe 
send me some mailing list address so I can get on them. I got your 
email address from the January 1997 issue of Windows 
Developer's Journal. 

There are a couple of forums on CompuServe that are excellent 
sources of VB programming information, and I'm guessing that 
those are what your books are referring to. Unfortunately, those are 
CompuServe forums, not mailing lists, so there's no way that I know 
of to read or participate in them without buying a CompuServe 
account. I think CompuServe has contemplated making their pro¬ 
prietary forums accessible via the Web for a fee, but so far as I 
know, that option is not available yet. You can always read and par¬ 
ticipate in VB-related Usenet groups from AOL (or from any 
Internet service provider), though the signal-to-noise ratio is not 
always as good as in specific CompuServe forums. —rib 


From: “Gordon Brockway Jr.” <gordonB@dragonsys.com> 
Subject: annotator 

Your annotation program is a piece of junk. I am very disap¬ 
pointed. You shouldn’t advertise a product that fails so miserably. 

The annotation software is what it is: quickly hacked together soft¬ 
ware that we give away for free. If we charged money for it, I could 


afford to make it much better, but I suspect the current arrangement 
provides the best value to the most readers. The real value is in the text 
of the annotations themselves, which we also give away for free, and 
which you can easily grep (it’s just an ASCII text file) for information. 
If the annotater doesn’t work for you and you can describe some 
details of how it fails, I may be able to fix the problem as time permits. 
For example, with some help from readers, I eventually got around to 
making it work with the proprietary online help format used by VC++ 
v4.2. The annotator ain’t perfect, but enough readers are finding it 
useful that I don’t think we can discontinue offering it. —rib 


From: David Griffin <daveg@highwater.co.uk> 

Subject: Utility to report DLLs my code is using 
Hi there, 

I am a reader of Windows Developer’s Journal and I wondered if 
anyone there could answer my question. Some time ago I found a 
utility which displayed the DLLs used by an application/DLL. 
Unfortunately, some versions of NT and few hard disks later, I have 
lost the utility and don’t remember where I found it. Is there anyone 
out there who knows of such a tool? Does MSVC’s dumpbi n utility 
do what I want? I’m sure you can guess that I want to know which 
libs to distribute with my software. 

Thank goodness I have my trusty WDJ CD-ROM for questions 
like this! A quick search showed a couple of articles of potential 
interest. The November 1995 WDJ has a tool that monitors what 
DLLs get loaded (by anyone) at runtime, and then helps you track 
down what DLLs don’t get loaded. The August 1995 WDJ has an 
“import resolver” that sounds more like what you want — it scans a 
.exe and finds what DLLs it imports, then recursively scans those 
DLLs, and so on until it hopefully finds every module that your . exe 
(statically) depends on. The recursive part is what dumpbin won’t 
do for you. The corresponding code archives are on our Web site at 
www.wdj.com/source.htii). —rib 


Subject: ReadComm problems 
Author: Tim.Bolt@cambridge.simoco.com 

I haven’t been getting your magazine long, so I don’t know 
whether you have ever featured anything that might help, but I have 
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Demo / Tutorial / CBT / Presentation 


Visual Windows Automation 
Multimedia Authoring Development Kit 

□ Use ShowBasic Recorder to generate the editable, 
mouse/keyboard simulation code invariant to window's 
size and position, screen resolution and video driver. 

Gl Achieve visual control over external applications 
and unlimited flexibility by programming in full 
featured Basic extended with the unique presentation 
and CBT related functionality, use even access to 
external DLLs and Windows™ 16-bit or 32-bit API. 

LI Pack your application in a compressed executable 
with the small self-installed run-time and all supporting 
files (BMP, WMF, WAV, MIDI, AVI), compatible with 
Windows 3.1, Windows 95 and Windows NT . 

□ Deliver your titles transparently via WWW - 
ShowBasic can be integrated with any WEB browser. 

Development license $299 with 30 day money back guarantee. Royalty free license $X95. 

If you don’t need all the power of ShowBasic - use our simple, 

vet flexible scripting language for live demos and automation: 

STDEMO 

Single-user license $30 ($60 Pro). Royally free license $300 ($500 Pro). Visa/MC accepted. 

Find more information, demos, samples and evaluation copy: 

http://www.cnj.digex.net/~mik 

■ MIKSoft, Inc. tel/fax: 908-390-8986 

37 Landsdowne Road. East Brunswick NJ. 08816 
Internet: mik@cnj.digex.net CompuServe: 74127.3671 
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Looking 


WinGREP can find it 

WinGREP is a multi-file search utility 
that can quickly locate text strings in 
source code files. Extensive search 
options include replace, Delphi DFM 
searching, and DOS style wildcard 
searching. Tight integration into over a 
dozen editors and integrated develop¬ 
ment environments (IDE's) sets 
WinGREP apart from other search 
utilities. WinGREP can be customized 
to automatically synchronize an editor 
or IDE with the results of a search. Not 
only does it open the file, but it will also 
position to the line of the match. 
Supports Borland® C++, Microsoft 
Visual C++', Borland® Delphi', Premia® 
Codewrite', American Cybernetics 
Multi Edit, Micro Edge Visual Slick Edit 
and many more. Download a trial 
version at www.hurricanesoft.com 


16-bit & 32-bit versions 


TfciAL Version Available 


* Multi-file search and replace 
v" Fast search performance 
v Save, load, and print results 
✓ Easy regular expressions 
v Supports long file names 
s Search Delphi form(DFM) files 
v Search HTML and Java code 


$39 + 4sh(US) 
Toll Free 24hrs (US) 


(888) 946-4737 


s i 


Hurricane Software, Inc. 

www.hurricanesoft.com • CompuServe go WINUTIL 
e-mail mail@hurricanesoft.com • CompuServe 102470,2564 
2401 SE 7th • Blue Springs • MO 64014 • (816) 373-9252 
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Include frame based 


AN I/VI ATI ON 


in your programs with 

EG I 

• based on the FLIC file format 

• 16-bit & 32-bit player DLLs 

• comprehensive API, well documented 

• source available 

Extend the FLIC file format with: 

• advanced lossless compression 

• transparency masks 

• segmented animations 

• synchronization with external events 

Evaluation version at: 

http://ourworld.compuserve.com/homepai; es/compuphase 

CompuPhase, The Netherlands 
® +31.35.693.9261 (voice) 

I +31.35.693.9293 (fax) 

1001 1 5.2074@compuserve.com 
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VICTOR 

Image Processing Library 

Fast BMPATIFF/PCX/GIF/TGA/JPEG 
Powerful image processing: brightness, 
contrast, sharpen, smooth, equalize, 
create filters, resize, rotate, +++ 
Accurate color reduction to optimum, 
specific, or standard palette 
Print halftone, diffusion scatter, or color 
Scan with all HP scanners 
Operate on single image, multiple 
images, or any image area 
Crop, combine, and compare images 

Victor Image Processing Library 
Dos lib $199, 16-bit DLL $299, 32-bit DLL $499 

Catenary Systems 
314-962-7833/fax: 314-962-8037 
email: victor@catenary.com 

askforfreedemo srcavail noroyalties 
Visit our website for demos, app notes, and sample code 

http://www.catenary.com/victor 
a Request Reader Service #157 o 
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Programming Tools 
For Programmers 


VB • DELPHI • CLIPPER 
INTERNET • VdBASE • VO 


• Product Info 

I 

• Demos 

• Online Ordering 9 

• Online Delivery 

• Training 



Get Connected! 

www.zaccatalog.com 
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6 Great Controls! 


TE Edit Control (Advanced RTF control). 
HTML Viewer/Editor Add-on for TE. 
ReportEase Plus (report writer engine). 
SpellTime DLL and dictionary. 

Rich Text Grid control. 

ChartPro (bar, pie, line, hilo, point). 


All products include complete 
source code, are royalty free and 
available for 16 or 32 bits. 

Sub Systems, Inc. 

11 Tiger Row,Georgetown, MA 01833 
508-352-9020 Fax: 508-352-9019 
Demos: www.subsystems.com 
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C++ t<3 


© 


Object outline 

• New Version 

• Generates documentation directly 
from the source code 

• Metrics 

• HTML and RTF output 

• No source code changes 

• Windows 95 and NT 3.51, NT 4.0 

• FREE evaluation version at www.bbeesoft.com 

Order by calling 1-800-214-4746. 
fax an order to 1 -800-657-8141, costs ! 297 US dollars 



o m p a 1 


email info@bbeesoft.com, PO Box 541, Hudson, MA 01749 
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Competitive Position™ Market Reports 
Present Detailed and Extensive 


Salary Statistics 


Explained and Illustrated in Graphs 
Specifically for Different Positions & Skills 


• Programmer 

• Quality Assurance 

• Administrator 

• Support 


• Programming 

Language 

• Software 

• Network 


Including: 

C/C++ Programmer 

Visual Basic/Powerbuilder 
Programmer 

Instant Online Download 

http://www.whoIeroot.com 

Whole Root™ Economic Research. Inc. 
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a problem. If you can either offer any suggestions or point me 
toward someone who can, I would be very grateful. 

We have inherited a Windows 3.1 app to maintain, written in the 
days when 486s were fast machines, using C++ and the SDK. 
When we moved the app from 33MHz 486s onto 133MHz 
Pentiums, we started seeing occasional hardware overruns on calls 
to ReadCommt ), with a consequent loss of a character here and 
there. A simple comm program works OK on either machine, but 
our comms program is one of two background tasks. The schedul¬ 
ing is done by using Yield!) and interprocess communication is 
by DDE messaging. 

What could we be doing that is apparently preventing Windows 
from servicing hardware interrupts, and why does it affect the fast 
machine rather than the slow one? 

I suspect some reader out there knows the exact answer. I’m no 
serial port expert, but my uninformed guess would be that the faster 
machine has a UART that supports buffering and that the serial port 


driver is not using it intelligently. Perhaps one of our readers will 
send you a more expert answer. —rib 


From: Paul Perry [71530,3701] 

Hi Ron, 

I enjoy WDJ very much, and it seems like I learn something 
new from each issue. I have a question for you. It used to be that in 
order to have a good grasp of Windows programming, the begin¬ 
ner programmer was told to learn the API, usually via Petzold, and 
always programming in C. With class libraries for C++ like MFC, 
and RAD development tools like VB, Delphi, and now C++ 
Builder becoming more popular and increasingly more powerful, 
it seems like knowing the API is an old art, and one that people 
don’t think is valuable. I consider you an expert in the field, and 
would like your opinion on this. 

My question is, Do you think it is still important to know how to 
program for Windows (specifically NT) with C, using the standard 



C and C++ DOCUMENTATION 


!! VERSION 7.0!! 

• C-CflLL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates comment- 
blocks for each function, listing the functions 
and identifiers used by it. 

• C-METRIC ($59) Counts path complexity, counts 
comments, code, 'C' statements. 

• C-LIST ($69) Lists and action-diagrams, or 
reformats into standard formats. 

• C-REF ($69) Creates cross-reference of local/ 
global/define/parameter identifiers. 

• C-DOC ($199) Package All 5 programs integrated 
as DOS program. <10,000 lines. 

V6.0 C-BR0WSE Windows graphic-tree viewer. 

• C-00C Professional ($299) DOS, Windows, OS/2. 
3-ring binder/case. <1,000,000 lines. 

30-DAY Money-back guarantee. CALL NOW! 

SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga Voice/Fax (905) 858-4466 
ONT Canada L5N-4M1 http://www.swbs.com 


Please see Ad Index for our larger ad. 
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S/W ENGINEERING POSITIONS NATIONWIDE 


5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax:310-641-2900 


We Understand 
Programmer's 
Mind." 


When the country's 
top firms look for 
the best develop¬ 
ers available, they 
turn to Bateman. 
Why? Because we 
specialize in MS 
Windows. NT, OS/ 
2 and Macintosh re¬ 
cruiting nationwide. 
So if it's time for a 
career move, give 
us a call. We un¬ 
derstand your 
skills, and the mar¬ 
ketplace for them... 
we understand you. 


K Bateman Inc. 
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NOW IN EUROPE 


FOR ALL EUROPEAN SOFTWARE VENDORS 

In order to serve our European advertising 
customers better, the Windows Developer's 
Journal now has a European Advertising 
Representative located in Germany. 

Now it is even easier for you to reach over 22,000 
experienced Windows programmers worldwide 
with an advertisement in the Windows 
Developer's Journal. 

Windows 

The Magazine for Windows Programmers 

breakout! marketing 
Duevelsbeker Weg 4 
24105 Kiel 
Germany 

Phone: +49 431 801740 FAX: +49 431 801797 
email: 100332.1704@compuserve.com 


Wouldn't it be nice to make your 
product known around the world? 



IW3 WWW Connectivity •’•UNIQUE*** 

• Connect applications with the World Wide Web • Make 
host application useable through web browsers • 3270, 
5250 and 9750 available via HLLAPI • HTML generator 

• VisualBasic support - Write a web server with VB - 

PicasSO Interface Generator 

• Creates new interfaces for existing host and DOS apps. 

• Supports 9750, 3270 and 5250. • HLLAPI interface • 
Built-in form editor • Transformation tools • Codegenerator 
produces complete program source • Host screen capture. 
WWW option available. 

PrimaVista Interactive Presentation 

• Annotations with mouse, keyboard and pen. • Screen 
camera, graphics import, Photo CD. • Arrange, scale, crop, 
undo and redo. • RTF editor and thumbnail images. 

TOOlS PrimaCamera and WinGate Products 

• Camera captures popup menus • WinGate: DOS pipes • 
RobinHood: DOS box control • WinTunnel: data exchange 

PrintForm Formatting Toot 

• Makes impossible reports possible. • Lean, mean and 
fast, supports MFC • Suited for object oriented data bases. 

(3) +49.89.78581204 ESC 
J +49.89.78581205 0) +1.913.832.2070 
info@cobasoft.com ® +1.913.832.8787 
Cobasoft www.cobasoft.comwww.esconnect.com 
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Software Developers! 



* ProMath/VB - numerics/statistics. $149 

* FinLib/VB - financial calculations. $149 


* SpellCheck/VB - spelling & lookup. $49 

* Dazzle/VB - image manipulation. $199 

* VBIite - print/comm/array/B-Tree ind e\..$149 

* VoxLib/Pro - multi-line telephony/callid .$799 

* BarMagic - bar code toolbox. $299 

* QB/C/dBase - 15 more DOS libraries ...$call 

* Custom - C, VB, ASM programming ,...S80/h 
Develop your VB app faster: Get TeraTech tools! Call, E-mail 
or fax us and well mail you a free demo disk ASAP, Or for 


faster service download by FTP or from our BBS. Call now! 



Inti:+1-301-424-3903 Fax:(301)762-8185 BBS: (301)762-8184 
info@teratech.com http://www.teratech.com/teratech/ 


PROTECT YOUr 
Software. 
INCREASE Your 
Revenues. 

With software piracy costing you 
50% of your revenues, you can't ^ 
afford not to protect! HASP® is 
the industry's most secure, flexible 
and easy-to-use software protection 
solution - rated #1 by the NSTL! 

HASP will help you increase sales, control 
distribution, prevent piracy, monitor network 
licensing, and much more! 

To learn how you can easily sell more software - call 
now to order your low-cost HASP Developer’s Kit! 



Norh America 800-223-4277 
212-564-5678. Fax: 212-564-3377 
E-mail: hasp.sales@us.aks.com 
International - *72-3-636 2222 
Fax:972-3-537 5796 
E-mail: hasp.sales@aks.com 


www.aks.com 


ALADDIN 


The Professional's Choice 


ZIP 


XIX 


XCEED ZIP 

COMPRESSION LIBRARY 


16 and 32 bit Delphi VCLs. VBX, OCX 


Finally, a compression component that 
gives you your money's worth! Add 
Xceed Zip to your project, set a few 
properties, and your apps will be ziping 
and unziping in minutes. Great for 
automating backups, preparing files 
for transmission, or developing your 
own custom installer. 



( 800 ) 865-2826 
( 614 ) 4 - 42-2626 


Visit www.xceedsoft.com/dev for a 
free trial version and find out 
why Xceed Zip is rapidly becoming 
the most popular VB and Delphi 
compression library! 
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DISKETTE & 
CD DUPLICATION 


Let us send out your Demo Disks 

• DISK DUPLICATION 

• LABELS/DISK & CD 

• CD DUPLICATION 

• FULFILLMENT 

• BLANK MEDIA 
• LOW PRICES 

• FAST TURNAROUND 

DUPLICATION TECHNOLOGIES, LTD. 
P.O. BOX O, WELLINGTON, MO 64097 
TOLL FREE (888) 899-3475 
PHONE (816) 934-8518 FAX (816) 934-2590 
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Data Rescue's 
Interactive Disassembler 
Pro Version 3.6 


► DOS, WIN32 console, OS/2 hosted workshell 

► interactive auto-commenting disassembler 

► STANDARD LIBRARIES RECOGNITION (FLIRT) 

► background analysis, unlimited size of input file 

► EXE, NE, LE, PE, LX, NLM, Binary, ROM and more 

► 80x86, Pentium*", Pentium Pro*", MMX 

► Z80, 8051,6502, 68K and more Still 

► JAVA $199 

► functions, arrays, structures and more 

► outputs ASM, EXE, MAP, LST, DIF, IDC 

► interactive C like internal language 


Fast Library Identification and Recognition 
Technology relegates classical disassembler 
technology into prehistory. Your disassemblies 
suddenly come alive and familiar symbols and 
structure spring in sight Check 
HTTP Y/WWW.DATARESCUE. COM/I DA.HTM 
for more information 
GET yourself a FLIRTING disassembler I 

http://www datarescue.com - http://www.ccso.com 
info@datarescue.com fax+32-4-3446514 
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The best high 
performance, 
portable 
compression 
libraries for 
DOS, Windows, 
OS/2, Unix, 
Macintosh, 
embedded systems, 
and practically anything 
else, period. 


FREE DEMO 

DOS $249 
Win 16 $299 

Win32 $299 
OS/2 $349 
Unix $349 
Macintosh $349 

Kg DC Micro 
Ssl Development 


45-function API 
Buffer compression 
File compression 
Disk spanning 
Encryption 
Self-extracting EXE's 
VBX/OCX controls 
On-line help 
Full source code 
Tel 606-245-4175 
Fax 606-245-9305 


Call 1-800-775-1073 

info@dcmicro.com http://www.dcmicro.com 
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www.dice.com 


DICE is looking for Data Processing, Engineering and 
Technical Writing professionals to fill open positions 
for companies nationwide. 

DICE is a FREE online job search service, providing 
detailed information about current contract and fulltime 
positions across the USA. Please contact by calling ANY of 
these access numbers, using your computer & 1200-9600 
baud Modem, 8-N-l. 


California. 

Georgia 

Illinois 

Iowa 

Massachusetts 
New Jersey 
Texas 
Internet 
Web 


408-737-9339 
404-523-1341 
708-782-0960 
515-280-3423 
617-266-1080 
201-242-4166 
214-691-3420 
telnet dice.com 
www.dice.com 


DATA PROCESSING 
I NDEPENDENT 

Consultant's! 

E XCHANGE . 

A Service of D&L Online, Inc:. (515) 280-1144 


3 Request Reader Service #158 3 


Developer Jobs! 

Internet: das@scientific.com 


Commercial software developers should reg¬ 
ister with Scientific Placement. R&D jobs for 
software engineers, SQA, product managers, 
etc. Nationwide contacts with both large and 
small companies including start-ups. Many 
clients develop and publish commercial soft¬ 
ware products. Most develop for Windows, 
NT. Macintosh, OS/2, and Unix based plat¬ 
forms. We also recruit in other leading edge 
technology areas such as PDA, low level and 
real-time, compilers, etc. Managed by gradu¬ 
ate engineers. Send resume or call to get an 
assessment of your marketability. Never a fee. 

Scientific Placement, Inc. 
800-231-5920 Fax 800-757-9003 
http://www.scientific.com 


CompuServe: 71250,3001 AOL:davesmall 
Q, Box 19949, Houston, TX 77224 
281-496-6100 Fax:281-496-0373 
CJ, Box 71, San Ramon, CA 94583 
510-733-6168 Beth@spica.bdt.com 
CJ, Box 202676, Austin, TX 78720-2676 
512-331-0302 lej@zilker.net 


1 

O 
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Dr. DeeBee 
ODBC Tools 


Tools for ODBC development 

Ever wonder why 
your ODBC app is not 
working? Why it’s just 
too slow? If the ODBC 
driver is OK? 

Dr. DeeBee utilities reveal the inner workings of ODBC. 



Dr. DeeBee ODBC Driver Kit 



Connect proprietary databases to 
Access. Visual Basic, and PowerBuilder 
with nur Dr. DeeBee ODBC Driver Kit 


-SYVWAEZ - 

RO. Box 91 Kendall, Cambridge. MA 02142 
G17- 497-1376 Fax 617-497-8729 
http://www.syware.com 
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Windows API? Are there any advantages to programming in C? 

Let’s put it this way: it’s extremely important that someone on 
your Windows programming team be familiar with the Windows 
API. They may not have gained that familiarity by programming in 
straight C, but that’s a pretty common method. The higher-level 
tools are great — right up until the moment you want to do some¬ 
thing the designers of that high-level tool did not anticipate. And 
then you need to know how Windows works. 

I’ve been programming mostly in C++ for a number of years, 
and if you had asked me whether there are any advantages to writ¬ 
ing Windows programming in C a year ago, I probably would have 
said "no.” However, since I started working on a DLL of reusable 
Windows code, I’ve changed my mind a bit. Using straight C, I can 
easily build a Win32 DLL that does something useful and that fits in 
10Kb; with C++, that DLL would be much larger. 

More importantly, though, I feel I can debug and rigorously test 
that C DLL easier than 1 could the equivalent C++ DLL. I still use 


C++ and wouldn’t use anything else for most large software pro¬ 
jects, but I can really see a place now for C in building reusable 
DLLs that handle lower-level functions likely to be useful in multi¬ 
ple projects. 

So now, I develop regularly in both C+ + and straight C. When 
I discover low-level functionality likely to be useful across multi¬ 
ple projects, my goal is to add that to my utility DLL, written in 
and exposed as straight C functions. The rest of my code is gener¬ 
ally written in C++. It takes a little mental gear-shifting to switch 
between the two languages (I don’t try to make my C code look 
like C++ or vice versa), but it only requires a little extra disci¬ 
pline. No language that achieves widespread use goes away 
overnight, and I think C is going to continue to be useful for quite 
some time to come. —rib □ 



Developer's 


Marketplace 


Client/Server CASE Tool! 





Visual C++ & Delphi Support! 

ER modelling tool with Form Generator, Logical & Physical 
Database Design, Reverse Engineering, Tnggers & Stored 
Procedures, Scripting Language, Programmable Database 
support and hundreds of other features. 

Pro Edition Only S485 
Case Laboratories, PB 58,4033 Forus, Norway 
Fax (47) 51 57 01 17 email: JANVB@CASELABS.COM 


Download a IKII. Demo front 
in nr. easel a hs. com 
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COPY PROTECTION 

INTERNET ACTIVATION 

Az-Tech Software, Inc. 
Leaders in Software Security 
INTERNET 
CPU-LOCK 
HDD-LOCK 

CD-ROM LOCK (Software Based) 
REMOTE ACTIVATION 
EXECUTION LIMITS 
LIMITED INSTALLS 
REMOTE RESETS 
SERIALIZATION 
REGISTRATION (Secure Distribution) 

ACCESS FLAGS 
DATE LIMITS 
NET LIMITS 
"POINT & SHOOT” 

WIN95*3.11*DOS 

Phone: (816) 776-2700 x320 
Fax: (816) 776-8398 * Dept: SMG-320 

Internet: www.az-tech.com ,- 

_ E-Mail: sales@az-tech.com |20 




(Hardware Based) 
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ActiveX Charge 

Add Credit Card Processing to Your Applications. 


PC-Charge makes it easy to process Credit Cards, Debit Cards 
and Check services in your Windows Applications. Sales, > 
Credits, Voids-everything you need to replace that bank card 
terminal (little black box). 

• ActiveX and VBX Controls make it easy to integrate. ; 

• Pre-Certified with all major credit card processing 
companies. 

• Single and Multi-User Versions. 

• Works with Visual Basic, Visual C++, PowerBuilder, 

Access, Delphi and many more languages. 

• 30 day money back guarantee. 

• Starts at $295. 



The Leaders in Innovative Transaction Processing Solutions 

31 Sherborne Road • Savannah, GA 31419 
Tele: (912) 925-4048 Fax: (912) 927-0214 
http://www.gosoftinc.com 
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Reach the core of the 
Windows programming market: 


WindHows 

QgmgamaEg msw 

The Magazine for Windows Programmers 

The ONLY independent magazine 
that focuses exclusively on the 
"nuts and bolts" of building 
sophisticated Windows applications. 

Put your tools where 
professional Windows developers 
go when they need advanced 
information about developing 
Windows applications - Call today! 


I Ed MacMillan - East I Daniel Lassley - West 
913-838-7513 I 913-838-7541 

I breakout! marketing - Continental Europe 
+49 431-801740 

www.wdj.com 


CDROMs! 


Linux Slackware® 96-4 disc set. Slackware 96 ‘OFFICIAL* 
release by Patrick Volkerding. Internet's favorite! You get 
complete source code and compilers. Free 36 page 
installation booklet. No floppy disc install! $39.95 

Slackware subscription - convenient 3 month updates. $24.95 
FreeBSD® 2.1.5 - Berkeley BSD for PC. Solid Unix*-like, sre, 

XFree86 3.1.2, dev. tools. 2 CDs. (Subscr. every 6 mo. $24.95) $39.95 
CUG Library - 10 years C/C++ Users' Journal sic, listings. $49.95 
CICA® MS Windows - 1,916 up-to-date shareware. 2 CDs. $29.95' 
Hobbes® OS/2 Archived - 950 MB OS/2 apps, drivers. $29.95' 
Blackhawk 95 - 520 MB great Windows 95 applications. $29.95 
Toolkit for Quake - add-ons for the hottest selling game. $19.95' 
Simtel® MSD0S - 2 disc set, classic MSDOS shareware. $29.95' 
Science Library - Technical, engineering shareware + book. $39.95' 
Perl - Source, binaries for many systems, documents. $39.95 
Math Solutions - Math programs, source code, docs. $39.95' 
POV-Ray - 3-D Raytracing: 1000 wow! images, sre/binaries. $39.95 

‘Shareware programs require separate payment to authors if found useful. 


ORDER NOW! 1-800-786-9907 


Shipping is $5 in USA/Canada/Mexico, $9 Overseas per order. 
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Walnut Creek CDROM 

Suite D-694, 4041 Pike Lane, Concord CA 94520 
Phone: +1-510-674-0783 • FAX: +1-510-674-0821 • email:orders@cdrom.com 
All of our CDROMs have a one year unconditional guarantee! 

Call today for your free catalog of all our CDROM titles! 

See these products free at http://www.cdrom.com/ 


Adcode: 694 
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Windows 


Solaris 

HP-UX 

AIX 

SGI 

SCO 

MAC 

PowerMac 


and Much MoreJ 


ACCUSOFT 
IMAGE „ 
GUARANTEE 


The Musi' CumerelieiisLY e 
ihili£ Tuqllvtt qli the PLanef 


Versions 

Available 


Win95/NT 
MIPS NT 
Alpha NT 
VBX 

ActiveX(OCX) 
OS/2 
SUN OS 


** GveL* Ss File Famuiis 


, 

feiiiiiieT 


Scan, Display & Print 


Document Imagin 


Scale-to-Gray 


Yt?.lrfTr? 


The Next Generation of Imaging Technology for Developers 


DICOM 3 
and others 


ImageGear™ 6.0 shifts your development schedule into 
warp drive by providing you with the most 
comprehensive, easiest to use image processing solution 
available. With support for over 45 file formats and an 
API featuring 200 plus functions, ImageGear is the 
toolkit that no developer should be without. 

Standard and Pro Gold™ versions allow you to purchase 
the level of performance and functionality you need. 
ImageGear offers the high speed display of both bitonal 
and full color images with functions like scale-to-gray, 
automatic aspect-ratio correction, panning window, 
magnify window, and much more. Advanced features 
like auto-deskew, sub-pixel display accuracy, rotate to 
any angle, and special effects add robust image 


Visit our Website @ www.accusoft.com 

49k FREE ImageGear 6.0 Demo 49k Comprehensive Product Info 
ImageGear Special FX in Action 49k Imaging Toolkit Glossary and Much More! 


AccuSoft Corporation 

Two Westborough Business Park 
Westborough, MA 01581 
Tel (508) 898-2770 
FAX (508) 898-9662 


AccuSoft 

High Performance Imaging 

Call lor FREE Demo! Toll Free: (800) 741-7720 
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processing to any application. ImageGear's new display 
technology is fast and easy to use and printing is more 
accurate than ever with new high-level functions. The 
TWAIN scanning interface with support for 32-bit 
drivers gives you complete control. GUI functions 
make integration quick and seamless, and multi¬ 
platform support provides a complete solution to 
portability issues. 

The AccuSoft Image Guarantee™ assures that your 
application will read every valid image. You can turn to 
us with confidence because we have over ten years of 
experience as the leader in quality image processing. 

So call the experts at AccuSoft, and step up to the next 
level in quality and performance with ImageGear. 


MINUTE 

Delivery 


WD5 

















OVER 40 
FILE FORMATS 


TIFF 6.0 

CAL 

PCX 

DIB 

BMP 

EPS 

PNG 

FAX (raw) 

KODAK 

- F|ashpix 

DCX 

IMG 

-Photo CD 

IOCA 

JPEG 

MODCA 

-JFIF 

MAC 

-JTIF 

Eg> -Progressive 

Egl> C ^o P g ressive 

fe^\ G ' F 

1 -- A -Animated 

MSP 

WINFAX 

VDA 

RAS 

WMF 

PSD 

-Interlace 

WPG 

-Transparency 

TGA 

-Embedded Text 

PCT 


For a Complete List Visit 
www.leadtools.com/format.htm 



Boolean & Math Combine 
Brightness & Contrast 
Color Reduction & Expansion 
Color Separation 
Edge Detection 
Emboss 

Gamma Correction 
Geometric Transforms 
Halftone & Grayscale 
Histogram Equalization 
Hue & Saturation 
Morphological Filters 
Noise Removal 
Region Of Interest 
Sharpen & Blur 
Spatial Filters 
Watermarks 




For a Complete List Visit 
s.leadtools. com/processing, htm 

Animation 
Auto dithering 
Bitonal scaling options 
Special paint effects 



Compression 

Annotation 

Database 

Printing 


LEADing technology in image development tools. 



< Start | IB MS-DOS Prompt _1 V IMAGE HANDLER £0 to... [ |>3 LEADTOOLS Annotata. ■i'.'S-Z 6:50 PM 

Microsoft uses LEADTOOLS to make FrontPage more powerful. Symantec/Delrina uses LEADTOOLS to 
make WinFax more powerful. Corel uses LEADTOOLS to make Corel Draw more powerful. Detect a trend? 
These companies apd thousands of others use LEADTOOLS to make sure that their applications contain 
the best imaging technology available. These industry leaders know that they can trust LEADTOOLS to 
deliver the imaging technology they require in an easy to use, reliable and time saving professional 
development toolkit. 

Whether you are working with document or medical imaging, creating an imaging database, or adding 
images to a web page, using LEADTOOLS ensures that your application has the highest level of imaging 
technology previously found only in professional applications like Photoshop. With LEADTOOLS you will 
get the job done quickly and easily. 

LEADTOOLS is a comprehensive imaging toolkit with more than 200 functions, properties and methods, 
that help programmers integrate black & white, grayscale and color images into their applications. 
LEADTOOLS contains 11 categories include scanning, color conversion, display, annotations, image 
processing with region of interest, animation, compression, image format import/export filters, internet, 
database, and printing. 

The award winning LEADTOOLS is available as 1 6 &■ 32 bit DLLs, 16 & 32 ActiveX^, and a VBX, and 
includes extensive example source code for C/C+ + , MFC, Visual Basic, Delphi, Visual FoxPro, and Access 
(2.0 & 7.0). LEADTOOLS' mature and stable code is backed up by a 30-day money-back guarantee (US &- 
Canada only) and FREE technical support is available via phone, fax, BBS, Internet or CompuServe. 


“If I had to write my own personal version of 
Photoshop, LEADTOOLS is where I’d start.” 

Rich Grehan 
Byte Magazine 



800 - 637-1847 

900 Baxter St. Charlotte, NC 28204 704-332-5532 


“LEADTOOLS is an indispensable tool, we used it 
in the development of our FrontPage application". 

Tom Button 

Director of Marketing, Internet Platform & Tools division 

Microsoft 
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DOWNLOAD A DEMO 



http://www.leadtools.com/ 


Fax: 704-372-8161 CompuServe:"GO LEADTECH" 


LEADTOOLS is available in several versions, not all features are available in all versions. 

•License required from Unisys for formats using LZW compression. LEAD and LEADTOOLS are registered trademarks of LEAD Technologies, Inc. All other product names are trademarks of their respective owners. 
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